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

Teradata® DSA User Guide

Data Stream Architecture
Release Number
Release Date
October 2021
Content Type
User Guide
Publication ID
English (United States)


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


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


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


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
[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):
v|backup_version BackupVersion
[Optional] Backup version number. Enter latest or 0 for the latest save set.
Example: latest
[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.