Previous Topic: RESTORE MessageNext Topic: LISTDMS — Sample Output


LISTDMS — Listing the Archive Index

The LISTDMS command selectively lists the contents of the archive index.

The LISTDMS command syntax is:

LISTDMS {DA(dsname-list)}
{L(prefix-list)}
[STA]
[ALL]
[ARC]
[DUPLICATES]
DATA SET

A list of one or more data set names or patterns for which index entries are to be listed. The user ID will be prefixed to data set names not enclosed in quotes. DA('A.B.C') will list only the most current entry. DA('A.B.C/') will list all occurrences. Acceptable abbreviations for this keyword are DSN and DA.

LEVEL

Letter L is an acceptable abbreviation for level. A list of levels or data set name patterns to be listed. As with other TSO commands, the user ID is not prefixed to level entries. A prefix does not have to coincide with an index level. The entire index file can be listed by specifying L(/). This keyword can be used instead of the DSNAME parameter.

STATUS

This default parameter can also be specified to cause data set status information to be listed. An alternative keyword is STA. This parameter is mutually exclusive with the ALLOCATION and ARCHIVES parameters.

ALLOCATION

The presence of this parameter causes data set allocation information to be displayed. An alternate keyword is ALL. This parameter is mutually exclusive with the STATUS and ARCHIVES parameters.

ARCHIVES

The presence of this parameter causes archive volume information for the data set to be listed. An alternate keyword is ARC. This parameter is mutually exclusive with the STATUS and ALLOCATION parameters.

DUPLICATES

This optional parameter indicates that all versions of the specified data sets are to be listed. An alternate keyword is DUP. If this parameter is not specified, only the most recent copy of the data set will be displayed. If neither the data set nor the level parameter is specified, all entries under the user ID node will be listed. The status display is the default when no selection keyword has been specified.