Optional Parameters
- [ALIAS][ALTERNATEINDEX][CLUSTER][DATA]
- [GENERATIONDATAGROUP][INDEX][LIBRARYENTRIES]
- [NONVSAM][PAGESPACE][PATH][USERCATALOG]
- [VOLUMEENTRIES]
- specifies that certain types of entries are to be listed. Only
those entries whose type is specified are listed. For example, if
you specify CLUSTER but not DATA or INDEX, the cluster's entry is
listed and its associated data and index entries are not listed. If you use ENTRIES and also specify an entry type, the entryname is not listed unless it is of the specified type. You can specify as many entry types as desired. When you want to completely list a catalog, do not specify any entry type.
- ALIAS
- specifies that alias entries are to be listed.
- ALTERNATEINDEX
- specifies
that entries for alternate indexes are to be listed. If ALTERNATEINDEX
is specified and DATA and INDEX are not also specified, entries for
the alternate index's data and index components are not listed.
Abbreviation: AIX®
- CLUSTER
- specifies
that cluster entries are to be listed. If CLUSTER is specified and
DATA and INDEX are not also specified, entries for the cluster's data
and index components are not listed.
Abbreviation: CL
- DATA
- specifies
that entries for data components of clusters and alternate indexes
are to be listed.
If a VSAM object's name is specified and DATA is coded, only the object's data component entry is listed. When DATA is the only entry type parameter coded, the catalog's data component is not listed.
- GENERATIONDATAGROUP
- specifies
that entries for generation data groups are to be listed. GDSs in
the active state, existing at the time the LISTCAT command is entered,
are identified as such when ALL is specified.
Abbreviation: GDG
- INDEX
- specifies
that entries for index components of key-sequenced clusters and alternate
indexes are to be listed. If a VSAM object's name is specified and
INDEX is coded, only the object's index component entry is listed.
When INDEX is the only entry type parameter coded, the catalog's index
component is not listed.
Abbreviation: IX
- LIBRARYENTRIES(libent)
- specifies
that tape library entries are to be listed.
- libent
- specifies the name of the tape library entry.
Abbreviation: LIBENTRIES or LIBENT
- NONVSAM
- specifies
that entries for non-VSAM data sets are to be listed. If a generation
data group's name and non-VSAM are specified, GDSs in the deferred,
active, or rolled-off state, associated with the GDG are listed by
specifying the ALL option.
Abbreviation: NVSAM
- PAGESPACE
- specifies
that entries for page spaces are to be listed.
Abbreviation: PGSPC
- PATH
- specifies that entries for paths are to be listed.
- USERCATALOG
- specifies
that catalog connectors are to be listed. The user catalog connector
entries are in the master catalog. (User catalog connector entries
can also be in a user catalog, but the operating system does not recognize
them when searching for a user catalog.)
Abbreviation: UCAT
- VOLUMEENTRIES(volent)
- specifies
that tape library volume entries are to be listed. Prefix the name
of the tape volume with the letter 'V'. For example 'Vxxxxx', where
xxxxx equals the volume name. You can specify the CATALOG parameter
to list tape volume entries from a specific catalog.
- volent
- specifies the name of the tape volume entry to be listed.
Abbreviation: VOLENTRIES or VOLENT
- CATALOG(catname )
- specifies
the name of the catalog that contains the entries that are to be listed.
If CATALOG is coded, only entries from that catalog are listed. See Catalog Search Order for LISTCAT for information about the order in which
catalogs are searched.
- catname
- is the name of the catalog.
If the catalog's volume is physically mounted, it is dynamically allocated. The volume must be mounted as permanently resident or reserved.
Abbreviation: CAT
- CREATION(days)
- specifies
that entries of the indicated type (CLUSTER, DATA, and so on,) are
to be listed only if they were created the specified number of days
ago or earlier.
- days
- specifies the number of days ago. The maximum number that can be specified is 9999; zero indicates that all entries are to be listed.
Abbreviation: CREAT
- ENTRIES(entryname[ entryname...]) |
- LEVEL(level)
- NOCDILVL | CDILVL
-
ENTRIES specifies the names of entries to be listed.
Unexpired GDSs that have been rolled off and recataloged can be displayed using LISTCAT ENTRIES(gdg.*), LISTCAT LEVEL(gdg) where gdg is the original name of the GDG, LISTCAT HISTORY, and LISTCAT ALL. Current and deferred generations are displayed as well as those that have been rolled off, in alphabetical order.
For TSO/E users, TSO/E will prefix the user ID to the specified data set name when the ENTRIES parameter is unqualified. The userid is not prefixed when the LEVEL parameter is specified.
Exception: You can use LISTCAT ENTRY LEVEL command only to list the cluster information of the entry. To list the data component information for the entry, you must use the LISTCAT ENTRY ALL command.
- ENTRIES(entryname [ entryname...])
- specifies
the name or generic name of each entry to be listed. (See the generic
examples following the description of the LEVEL parameter.) When you
want to list the entries that describe a user catalog, the catalog's
volume must be physically mounted. You then specify the catalog's
name as the entryname.
Abbreviation: ENT
- LEVEL(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.
If you specify a generic level name, 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.
When you are using a generic name with the LEVEL parameter you can use a '%' . The'%'acts as a place holder for a single character. For example, you can specify the following:LISTCAT LVL(DMP.S7P2.D%%%%%%.T%%%%%%.YDMJBA00)
LEVEL can result in more than one user catalog being searched if the multilevel alias search level is greater than 1. For example if TEST is an alias for UCAT.ONE and TEST.PROD is an alias for UCAT.TWO, and the multilevel alias search level is 2, LEVEL(TEST) results in both catalogs being searched, and data sets satisfying both aliases are listed. If TEST and TEST.PROD are not defined as aliases, and there are catalogs called TEST.UCAT1 and TEST.UCAT2, LEVEL(TEST) with a multilevel alias search 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 this situation, where a level is being searched that is not also an alias, the master catalog and all user catalogs with the same high-level qualifier and a number of qualifiers equal to the multilevel alias search level are searched for data sets matching the level requested. This situation should not occur if proper aliases are defined for user catalogs.
When multiple catalogs are searched, the listed entries appear in sorted order within the catalogs to which they belong.
Abbreviation: LVL
- NOCDILVL | CDILVL
- You can only specify NOCDILLVL | CDILVL parameters with the LEVEL
parameter.
- NOCDILVL
- specifies that only the objects whose patterns match the LEVEL pattern be listed.
- CDILVL
- specifies that DATA and INDEX objects in CLUSTERs and AIXs be listed if at least one of the three objects matches the LEVEL pattern.
Examples of ENTRIES and LEVEL specifications:
Suppose a catalog contains the following names:
- A.A.B
- A.B.B
- A.B.B.C
- A.B.B.C.C
- A.C.C
- A.D
- A.E
- A
- If ENTRIES(A.*) is specified, entries 6 and 7 are listed.
- If ENTRIES(A.*.B) is specified, entries 1 and 2 are listed.
- If LEVEL(A.*.B) is specified, entries 1, 2, 3, and 4 are listed.
- If LEVEL(A) is specified, entries 1, 2, 3, 4, 5, 6, 7, and 8 are listed.
When using a generic name with the ENTRIES parameter, entries must have one qualifier in addition to those specified in the command.
When using the LEVEL parameter, associated entries (for example, data and index entries associated with a cluster) are not listed unless their names match the level of qualification.
If the specified cluster name is fully qualified and the data set name is the maximum length of 44 characters, more clusters than expected might be displayed. For fully qualified names use the ENTRIES parameter.
Restriction: LISTCAT LEVEL has a restriction on the number of entries that can be displayed due to the amount of available storage below the line (24-bit addressing).
- PREFIX|NOPREFIX
- specifies if the user ID will be added as the first qualifier
of the entry name. These keywords apply when IDCAMS LISCAT is invoked
by TSO and LISTCAT keyword ENTRY or LEVEL is specified. PREFIX/NOPREFIX
are ignored when LISTCAT is running in batch. PREFIX and NOPREFIX
are mutually exclusive.
- PREFIX
- specifies that the user ID will be added to entry names which are not enclosed in quotes. This is the default.
- NOPREFIX
- specifies that the user ID will not be added to the entry names. They will be processed as they are specified in the LISTCAT command.
- EXPIRATION(days)
- specifies
that entries of the indicated type (CLUSTER, DATA, and so on) are
to be listed only if they will expire in the specified number of days
or earlier.
- days
- specifies the number of days. The maximum number that can be specified is 9999 and it indicates that all entries are to be listed. Zero indicates that only entries that have already expired are to be listed.
Abbreviation: EXPIR
- FILE(ddname)
- specifies the name of a DD statement that identifies the devices and volumes that contain information in the VVDS that is to be listed. If FILE is not specified, the volumes are dynamically allocated. The volumes must be mounted as permanently resident or reserved.
- LIBRARY(libname)
- specifies
the name of the tape library entry for which tape volume entries are
to be listed. Only those tape volumes that are entries in the specified
tape library are listed.
- libname
- specifies a 1-to-8 character tape library name. You can use a partial tape library name followed by an * to list tape volume entries for more than one tape library.
Abbreviation: LIB
- NAME|HISTORY|VOLUME|ALLOCATION|ALL
- specifies the fields to be included for each entry listed. Interpreting LISTCAT Output Listings, shows the listed information
that results when you specify nothing (which defaults to NAME), HISTORY,
VOLUME, ALLOCATION, or ALL. For SMS-managed data sets and catalogs,
the SMS class names and last backup date are listed in addition to
the other fields specified. The class definitions are not displayed.
Exception: For tape library and tape volume entries, only the ALL parameter is functional. If the HISTORY, VOLUME, and ALLOCATION parameters are specified for tape library and tape volume entries, these parameters are ignored. If ALL is not specified, only the names of the tape library or tape volume entries are listed.
- NAME
- specifies
that the name and entry type of the entries are to be listed. Some
entry types are listed with their associated entries. The entry type
and name of the associated entry follow the listed entry's name. For
details, see ASN: Associations Group in Interpreting LISTCAT Output Listings.
For TSO/E users, only the name of each entry associated with the TSO/E user's prefix is listed when no other parameters are coded.
- HISTORY
- specifies
that only the following information is to be listed for each entry:
name, entry type, ownerid, creation date, expiration date, and release.
For GDG base and non-VSAM entries, status is also listed. For alternate
indexes, "SMS-managed (YES/NO)" is also listed. For SMS-managed
data sets, storage class, management class, data class, and last backup
date are also listed. If the last backup date is unavailable, as in
the case of migrated data 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 1 and Figure 1.
The OWNER-IDENT field in the HISTORY subset has been renamed DATASET-OWNER. This displays the contents of the data set owner field in the BCS. The ACCOUNT information is listed when the HISTORY or ALL parameter is specified.
Abbreviation: HIST
- VOLUME
- specifies
that the information provided by specifying HISTORY, plus the volume
serial numbers and device types allocated to the entries, are to be
listed. Volume information is only listed for data and index component
entries, non-VSAM data set entries, and user catalog connector entries.
For TSO/E users, only the name and volume serial numbers associated with the TSO/E user's prefix are listed when no other parameters are coded.
When ALIAS is specified with VOLUMES, the alias creation date is not listed. The alias creation date appears only for LISTCAT ALL or LISTCAT HISTORY.
Abbreviation: VOL
- ALLOCATION
- specifies
that the information provided by specifying VOLUME plus detailed information
about the allocation are to be listed. The information about allocation
is listed only for data and index component entries.
When ALIAS is specified with ALLOCATION, the alias creation date is not listed. The alias creation date appears only for LISTCAT ALL or LISTCAT HISTORY.
Abbreviation: ALLOC
- ALL
- specifies
that all fields are to be listed, including fields
that are not listed under the NAME, HISTORY, VOLUME, and ALLOCATION
options, such as CA-RECLAIM, and fields under ATTRIBUTES, and STATISTICS.
When multiple catalogs are searched, the listed entries appear in sorted order within the catalogs to which they belong.
- OUTFILE(ddname)
- specifies
a data set, other than the SYSPRINT data set, to receive the output
produced by LISTCAT (that is, the listed catalog entries). Completion
messages produced by access method services are sent to the SYSPRINT
data set, along with your job's JCL and input statements.
ddname identifies a DD statement that describes the alternate target data set. If OUTFILE is not specified, the entries are listed in the SYSPRINT data set. If an alternate data set is specified, it must meet the requirements in JCL DD Statement for an Alternate Target Data Set.
Abbreviation: OFILE