catsearch — Co:Z utility to list z/OS catalogs
catsearch [-d] [-l] [-m max_entries] filter_key
This z/OS Co:Z utility command wraps the Catalog Search Interface (IGGCSI00)
and provides a convenient display of information about the Datasets that match the
supplied filter_key.
The syntax of the filter_key and additional documentation can be found in the following IBM publication: DFSMS: Managing Catalogs - SC26-7409.
Listing the entire catalog (filter_key **) is dis-allowed.
-dInstructs the catsearch command to execute in pseudo directory mode. That is, only the unique segments within the current filter key are listed.
-lRequests long form information about the listed Datasets. This information includes Volume, last referred date, tracks, used, recfm, lrecl, blocksize, dsorg and Dataset name.
-m max_entriesChanges the maximum number of entries that will be returned by catsearch.
the default is 2000.
This example shows a long listing -l form of a
catsearch.
>catsearch -l user.coz.** Volume Referred Ext Tracks Used Recfm Lrecl BlkSz Dsorg Dsname WORK81 2008/09/24 1 30 ? U 0 6144 PO-E USER.COZ.LOADLIB WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.SAMPJCL WORK84 2008/09/11 1 1 1 U 0 6144 PS USER.COZ.TEST.SEQ WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.TESTJCL
This example shows the difference between the single and double asterisk filter key symbols. A single asterisk only lists datasets within the current segment; the double asterisk will span segments.
>catsearch -l user.coz.*
Volume Referred Ext Tracks Used Recfm Lrecl BlkSz Dsorg Dsname
WORK81 2008/09/24 1 30 ? U 0 6144 PO-E USER.COZ.LOADLIB
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.SAMPJCL
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.TESTJCL
>catsearch -l user.coz.**
Volume Referred Ext Tracks Used Recfm Lrecl BlkSz Dsorg Dsname
WORK81 2008/09/24 1 30 ? U 0 6144 PO-E USER.COZ.LOADLIB
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.SAMPJCL
WORK84 2008/09/11 1 1 1 U 0 6144 PS USER.COZ.TEST.SEQ
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.TESTJCLShows the use of the -d switch. Note that only the
partial (pseudo directory) is listed for USER.COZ.TEST, and that
there is no accompanying detailed information. Use of this option can be helpful when
dealing with large catalogs.
catsearch -dl user.coz.**
Volume Referred Ext Tracks Used Recfm Lrecl BlkSz Dsorg Dsname
WORK81 2008/09/24 1 30 ? U 0 6144 PO-E USER.COZ.LOADLIB
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.SAMPJCL
USER.COZ.TEST
WORK81 2008/09/24 1 15 4 FB 80 27920 PO USER.COZ.TESTJCL