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

1. If a catalog is specified in the CATALOG parameter, only that catalog is listed.2. The first user catalog in the current job step (STEPCAT) or, if none is given, thefirst user catalog specified in the current job (JOBCAT) is listed.Recommendation: You should not use JOBCAT and STEPCAT DD statements.By default, JOBCAT and STEPCAT DD statements are disabled.3. If no user catalog is named in the current job step or job, the master catalog islisted.If the command is not a generic LISTCAT and the ENTRIES or LEVEL parameter isused, or when the command is run through TSO/E, the order in which catalogsare searched when entries are to be listed using the LISTCAT command is:1. If a catalog is in the CATALOG parameter, only that catalog is searched. If theentry is not found, a no-entry-found error is returned.2. Any user catalog in the current job step (STEPCAT) is searched, or, if none isgiven for the job step, any user catalog specified for the current job (JOBCAT) issearched. If more than one catalog is given for the job step or job, the job stepor job catalogs are searched in order of concatenation. If the entry is found, noother catalog is searched.3. If the entry is not found, the entry’s name is a qualified name, and:v One or more of its qualifiers is the same as the name or the alias of a catalogthat user catalog is searched. If the entry is found, no other catalog is searched.4. The master catalog is searched. If the entry is not found, a no-entry-found erroris returned.When the ENTRIES parameter is used and this is a generic LISTCAT, the order inwhich catalogs are searched when entries are to be listed using the LISTCATcommand is:1. If a catalog is shown in the CATALOG parameter, only that catalog is searched.If an entry is not found that matches the supplied qualifiers, a no-entry-founderror is returned.2. Any user catalog in the current job step (STEPCAT) is searched, or, if none isgiven for the job step, any user catalog given for the current job (JOBCAT) issearched. If more than one catalog is specified for the job step or job, the jobstep or job catalogs are searched in order of concatenation. The catalog searchcontinues with step 3.3. If the entry’s name is a qualified name, and:v One or more of its qualifiers is the same as the name or the alias of a catalogis searched. The catalog search continues with step 4.4. The master catalog is searched. If an entry has not been found in any of thecatalogs searched that matched the supplied qualifiers, a no-entry-found erroris returned.Generic Catalog Selection for DELETE and LISTCATThe multilevel alias facility enhances generic catalog selection. If you use genericcatalog selection with multilevel aliases, you can select several catalogs if thenumber of qualification levels of the generic name is less than the maximum yoursystem allows. See z/OS DFSMS: Managing Catalogs for information about settingmultilevel alias levels in the catalog address space. If the number of qualificationlevels in the data set name is less than the maximum your system allows, andaliases exist that match the generic data set name, then every catalog related tothose aliases (including the master catalog) is selected.Chapter 1. Using Access Method Services 13