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

LISTCATAbbreviation: CATCREATION(days)specifies that entries of the indicated type (CLUSTER, DATA, and so on,) are tobe listed only if they were created the specified number of days ago or earlier.daysspecifies the number of days ago. The maximum number that can bespecified is 9999; zero indicates that all entries are to be listed.Abbreviation: CREATENTRIES(entryname[ entryname...]) |LEVEL(level)specifies the names of entries to be listed.Unexpired GDSs that have been rolled off and recataloged can be displayedusing LISTCAT ENTRIES(gdg.*), LISTCAT LEVEL(gdg) where gdg is theoriginal name of the GDG, LISTCAT HISTORY, and LISTCAT ALL. Currentand deferred generations are displayed as well as those that have been rolledoff, in alphabetical order.For TSO/E users, TSO/E will prefix the user ID to the specified data set namewhen the ENTRIES parameter is unqualified. The userid is not prefixed whenthe LEVEL parameter is specified.Exception: You can use LISTCAT ENTRY LEVEL command only to list thecluster information of the entry. To list the data component information for theentry, you must use the LISTCAT ENTRY ALL command.ENTRIES(entryname [ entryname...])specifies the name or generic name of each entry to be listed. (See thegeneric examples following the description of the LEVEL parameter.) Whenyou want to list the entries that describe a user catalog, the catalog’svolume must be physically mounted. You then specify the catalog’s nameas the entryname.Abbreviation: ENTLEVEL(level)specifies that all entries that match the level of qualification specified by(level) are to be listed irrespective of the number of additional qualifiers. Ifa generic level name is specified, only one qualifier replaces the *. The *must not be the last character specified in the LEVEL parameter.LEVEL(A.*) will give you an error message.LEVEL can result in more than one user catalog being searched if themultilevel alias search level is greater than 1. For example if TEST is analias for UCAT.ONE and TEST.PROD is an alias for UCAT.TWO, and themultilevel alias search level is 2, LEVEL(TEST) results in both catalogsbeing searched, and data sets satisfying both aliases are listed. If TEST andTEST.PROD are not defined as aliases, and there are catalogs calledTEST.UCAT1 and TEST.UCAT2, LEVEL(TEST) with a multilevel aliassearch level of 2 results in both catalogs, as well as the master catalog,being searched for data sets with a high-level qualifier of TEST. In thissituation, where a level is being searched that is not also an alias, themaster catalog and all user catalogs with the same high-level qualifier anda number of qualifiers equal to the multilevel alias search level are searched fordata sets matching the level requested. This situation should not occur ifproper aliases are defined for user catalogs.280 z/OS V1R6.0 DFSMS Access Method Services for Catalogs