LISTDSN
When the command lists a pattern of data sets, the copies per each data set are displayed separately, from the most current copy to the oldest, regardless of its type.
ENTRY and UNIQUEID are displayed to reference a specific copy in subsequent commands.
Syntax
[VOLume(<volumePattern>)]
[DATE(yyyy/mm/dd) | DATERange(yyyy/mm/dd-yyyy/mm/dd)]
[ENTry(<integer> | UNIQueid(<uniqueId>)]
[FIELDS(DEFAULT|ALL)]
[OUTPUT(TABLE|LIST)]
[NODUMP]
Required parameters
Parameter | Description |
|---|---|
dataSetNamePattern | A data set or a group of data sets You can also specify a pattern by using %, *, or **. For example, SYS2.PROC*, or SYS%.PROC*. You can enclose the pattern or data set name in apostrophes. For more information about how to specify a pattern, see Specifying-the-data-set-or-volume-for-the-CLI-command. |
Optional parameters
Option (short option) | Description | Format | Examples |
|---|---|---|---|
VOLume | The volume on which the data set resides | Full name or a pattern | SYSRES PROD* SYS%RS |
DATE | Requests backup copies or archives that were created on a specific date only DATE and DATERange are mutually exclusive. | yyyy/mm/dd | 2019/08/15 |
DATERange | Requests backup copies or archives that were created on a specific date range DATERange and DATE are mutually exclusive. | yyyy/mm/dd-yyyy/mm/dd | 2019/01/01-2019/08/15 |
ENTry | A positive sequential number from 0, 1, 2, and so on, representing the available entries of a backup copy, according to the specified criteria The entries are relative to the selection used in the LISTDSN command. | integer | 0—For the latest copy (default) 1—For the copy before the latest, and so on. |
UNIQueid | An 8-character ID that, when combined with the data set name, identifies each backup copy Using UNIQueid, you can refer to a specific copy of a data set in other commands (for example, RESTDSN) without having to specify any additional filters. UNIQueid and ENTRY are mutually exclusive. | 8 characters | You can take the UNIQueid from a previous LISTDSN command’s output and use it in subsequent commands, such as RESTDSN. |
FIELDS | Specifies the fields to print in the output. Valid values are DEFAULT and ALL. The default is DEFAULT. Specifying DEFAULT prints the following fields:
Specifying ALL prints the fields in DEFAULT, in addition to the following fields:
For more information about the output fields, see Output. | NA | NA |
OUTPUT | Specifies the output format Valid values are TABLE and LIST. The default is TABLE. | NA | NA |
NODUMP | Requests LISTDSN to display backup copies only, without data set copies found in volume full dumps The default behavior is to allow selection of backups from a volume full dump. | NA | NA |
Output
The LISTDSN output displays the given LISTDSN command and parameters, followed by the requested information. For every filtered data set, the following headline is displayed:
The headline is followed by a list of the available backup copies, archives, and imports. For each record on the list, the following details are displayed:
Field | Description | Format |
|---|---|---|
ENTRY | Integer representing the sequence of the displayed list The entries are relative to the filter used in the LISTDSN command. When you list a pattern, the ENTRY is displayed per data set. | 0,1,2,...—A backup copy or a copy from full dump, available for restore - —An archive or an import copy, not available for restore |
DATE | Date of creation | yyyy/mm/dd |
TIME | Local time when created | hh:mm:ss |
VOLUME | Volume on which the data set resides | vvvvvv |
TYPE | How the resource entry was created | Archive—Archived data set Backup—Backup copy Full Dump—Backup copy from a volume's full dump Cloud DS—Cloud data sets that originated from a JCL or an import policy |
COMMAND | Whether the version originated from a CLI command | Y—Originated from CLI N—Not originated from CLI |
CATALOGED | Whether the data set was cataloged during backup | Y—Yes N—Not cataloged - —When you list a data set copy from a volume full dump, no catalog information is available |
WARNING | Whether the copy or archive creation ended with warnings (DFDSS RC=4) The warnings have different causes, depending on DFDSS execution. | Y—Yes N—No |
EXPIRATION|EFFECTIVE_EXPIRATION | Current expiration date of the backup, archive, or import The EFFECTIVE_EXPIRATION field displays only when you specify OUTPUT (LIST). | yyyy/mm/dd NONE—The expiration date was not specified by either the catalog, VTOC, or SMS. N/A—The expiration date is not applicable for this type. |
UNIQUEID | An alphanumeric ID to uniquely identify the backup copy or archive | uniqueId |
ARCHIVE_TIMESTAMP | Archive creation time stamp | yyyy-mm-dd_hhmmss.microseconds |
BACKUP_TIMESTAMP | Backup creation time stamp | yyyy-mm-dd_hhmmss.microseconds |
USER_SPECIFIED_EXPIRATION_DATE | User-specified expiration date | yyyy/mm/dd |
CATALOG_CREATION_DATE | Catalog creation date | yyyy/mm/dd |
CATALOG_EXPIRATION DATE | Catalog expiration date | yyyy/mm/dd |
LABEL_CREATION_DATE | Label creation date This field is available only for import and CDS. | yyyy/mm/dd |
LABEL EXPIRATION DATE | Label expiration date This field is available only for import and CDS. | yyyy/mm/dd |
VTOC_CREATION_DATE | VTOC creation date This field is available only for backup and archive. | yyyy/mm/dd |
VTOC_EXPIRATION DATE | VTOC expiration date This field is available only for backup and archive. | yyyy/mm/dd |
CLOUD_SIZE | Size of the resource in bytes | cloudSize |
IS_SMS_MANAGED | Whether the resource is SMS managed | Y—The resource is SMS managed N—The resource is not SMS managed |
MC_NAME | The SMS management class name This field is available only if the resource is SMS-managed. | mcName |
SYSPLEX | Sysplex name of the data set origin | sysplexName |
SYSTEM | System name of the data set origin | systemName |
RECORD_FORMAT | Data set record format | recordFormat |
DSORG | Data set organization | dataSetOrganization |
Examples
The following examples demonstrate use of the command:
Listing all instances of a data set on a certain day
Listing all instances of a data set using a pattern
Listing all instances of a data set on a certain volume
Listing a data set pattern from a specific set of disks
Listing all instances of data sets starting with M9.*, created within a date range
Listing all instances of data sets starting with m9.*, with the OUTPUT(LIST) and FIELDS(ALL) parameters