z/OS V1R6.0 DFSMS Access Method Services for Catalogs

LISTCATlibnamespecifies a 1-to-8 character tape library name. You can use a partial tapelibrary name followed by an * to list tape volume entries for more than onetape library.Abbreviation: LIBNAME|HISTORY|VOLUME|ALLOCATION|ALLspecifies the fields to be included for each entry listed. Appendix B,“Interpreting LISTCAT Output Listings,” on page 357, shows the listedinformation that results when you specify nothing (which defaults to NAME),HISTORY, VOLUME, ALLOCATION, or ALL. For SMS-managed data sets andcatalogs, the SMS class names and last backup date are listed in addition to theother fields specified. The class definitions are not displayed.Exception: For tape library and tape volume entries, only the ALL parameter isfunctional. If the HISTORY, VOLUME, and ALLOCATION parameters arespecified for tape library and tape volume entries, these parameters areignored. If ALL is not specified, only the names of the tape library or tapevolume entries are listed.NAMEspecifies that the name and entry type of the entries are to be listed. Someentry types are listed with their associated entries. The entry type andname of the associated entry follow the listed entry’s name. For details, see“ASN: Associations Group” in Appendix A.For TSO/E users, only the name of each entry associated with the TSO/Euser’s prefix is listed when no other parameters are coded.HISTORYspecifies that only the following information is to be listed for each entry:name, entry type, ownerid, creation date, expiration date, and release. ForGDG base and non-VSAM entries, status is also listed. For alternateindexes, “SMS-managed (YES/NO)” is also listed. For SMS-managed datasets, storage class, management class, data class, and last backup date arealso listed. If the last backup date is unavailable, as in the case of migrateddata sets, LISTCAT displays a field of all “X’s” instead of an actual date.HISTORY can be specified for CLUSTER, DATA, INDEX,ALTERNATEINDEX, PATH, GENERATIONDATAGROUP, PAGESPACE,and NONVSAM. See examples, Figure 16 on page 403 and Figure 17 onpage 406.The OWNER-IDENT field in the HISTORY subset has been renamedDATASET-OWNER. This displays the contents of the data set owner fieldin the BCS. The ACCOUNT information is listed when the HISTORY orALL parameter is specified.Abbreviation: HISTVOLUMEspecifies that the information provided by specifying HISTORY, plus thevolume serial numbers and device types allocated to the entries, are to belisted. Volume information is only listed for data and index componententries, non-VSAM data set entries, and user catalog connector entries.For TSO/E users, only the name and volume serial numbers associatedwith the TSO/E user’s prefix are listed when no other parameters arecoded.282 z/OS V1R6.0 DFSMS Access Method Services for Catalogs