LISTDSN
When listing 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.
The following details are displayed:
- The time and date of the copy creation
- The name of the original volume
- The data set type
- Whether the data set is cataloged
- Whether there were warnings in the creation of the copy
- The expiration date at the time of the backup, archive, or import
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>)]
[NODUMP]
Required parameters
Parameter | Description |
|---|---|
dsnamePattern | A data set or a group of data sets Specify a pattern by using %, *, or **. For example, SYS2.PARMLIB, 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 Identifying the data set and volume for the command. |
Optional parameters
Option [short option] | Description | Format | Examples |
|---|---|---|---|
VOLUME[VOL] | 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[DATER] | 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[ENT] | 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 LIST command. When listing a pattern, the ENTRY is displayed per data set. | <integer> | 0—For the latest copy (default) 1—For the copy prior to the latest, and so on. |
UNIQueid[UNIQ] | 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 | UNIQueid can be taken from a previous LISTDSN command’s output, to be used in subsequent commands, such as RESTDSN. |
NODUMP | Requests that LISTDSN will 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. | N/A | N/A |
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:
Column | Description | Valid values |
|---|---|---|
ENTRY | An integer representing the sequence of the displayed list The entries are relative to the filter used in the LISTDSN command. When listing a pattern, the ENTRY is displayed per data set. | 0,1,2,...—A backup copy or a copy from full-dump, available for restore |
DATE | The date of creation | yyyy/mm/dd |
TIME | The local time when created | hh:mm:ss |
VOLUME | The volume on which the data set resides | vvvvvv |
TYPE | How the backup copy, archive, or Cloud DS was created | Archive—An archived data set Backup—A backup copy Full Dump—A backup copy from a volume's full dump Cloud data set |
CMD | Specifies whether the version originated from a CLI command or not | N—Not originated from CLI Y—Originated from CLI |
C | Whether the data set was cataloged during backup | Y—Yes N—Not cataloged '-'—When listing a data set copy from a volume full dump, no catalog information is available |
W | Whether the copy or archive creation ended with warnings (DFDSS RC=4) The warnings could be a result of numerous causes, depending on DFDSS execution. | Y—Yes. The copy or archive creation ended with RC=4. Refer to the backup log in the UI to see DFDSS details. N—No |
EXPIRATION | The current expiration date of the backup, archive, or import | 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 8-character ID value to uniquely identify the backup copy or archive | 8 characters |
Examples
The following examples demonstrate use of the command:
In this example, backup copies exist for two different data sets with the same name. One is cataloged on the volume M9USER, the other is not cataloged and resides on volume N0QS01. On the specified day, the backup was performed twice on both data sets. One of the backup copies ended with a warning and appears as W=Y.
There were 2 data sets selected by the specified pattern. The first one is the same as the one displayed in the previous example. The second one has 3 backup copies, from a cataloged data set on disk M9USER.
The display is the same as shown in the example above, with the exception that the backup copies that are being displayed are copies of the data set that resides on volume NOQS01.
