list_save_sets | Teradata DSA Commands - 17.20 - list_save_sets - BAR - Data Stream Architecture

Teradata® DSA User Guide

Product
BAR
Data Stream Architecture
Release Number
17.20
Release Date
October 2021
Content Type
User Guide
Publication ID
B035-3150-101K
Language
English (United States)

Purpose

The list_save_sets command lists all valid save sets for a specified job name.

Syntax

list_save_sets -n|-name Name -C -F|-filter FILTER -v|backup_version BackupVersion -B|backup_repository

Examples

dsc list_save_sets -n job1 -F LAST_WEEK

dsc list_save_sets -n targetgroup1 -F LAST_WEEK -B

dsc list_save_sets -n job2 -C

Parameters

n|name Name
The name of the job or target group for its save sets. If -B is not specified, name refers to a backup job. If -B is specified, name refers to a repository target group name.
Example: job1
C|correlated_object
[Optional] Lists the correlated save sets that result when you run the skipped objects option with run_job -I. The save set missing the skipped objects is listed first and the save set containing the skipped objects is listed second.
The specified job must be part of a correlated pair.
Save sets are not listed if they have expired.
Example: # dsc list_save_sets -n LV500001 -C
F|filter FILTER
[Optional] Filter the save sets by the stop_time. Enter one of the following (must be UPPERCASE):
  • LAST_WEEK
  • LAST_MONTH
  • LAST_YEAR
Example: LAST_MONTH
v|backup_version BackupVersion
[Optional] Backup version number. Enter latest or 0 for the latest save set.
Example: latest
B|backup_repository
[Optional] View the backup repository for DSC repository backup save sets.
b|bucket BucketNumber
[Optional] Select a bucket number to display a grouping of data when too many results return to display at once. The command output notifies you if there are more buckets of data to display.

The -b parameter cannot be used with either the -F or -v parameters.

Usage Notes

The -b parameter cannot be used with either -F or -v.

If you specify the -B parameter and no save sets are available, the command builds a job plan from data or metadata files, if they exist.

If you run list_save_sets -C against a job that has no correlated pairs, the No SaveSets found error is generated.

XML File Example

This command does not support an XML file.