Name
catsearch — Co:Z utility to list z/OS catalogs
Synopsis
catsearch [-l] [-t [delim_char]] [-m max_entries] [-e entry_types>] filter_key
Description
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.
Options
-lRequests long form information about the listed Datasets. This information includes Volume, last referred date, tracks, used, recfm, lrecl, blocksize, dsorg and Dataset name.
-tRequests long form information about the listed Datasets in delimited format. If
delim_charis supplied, it is used as a delimiter, otherwise a tab character (\t) is used.-mmax_entriesChanges the maximum number of entries that will be returned by catsearch. the default is
2000.-eentry_typesChanges the default entry type filter for catsearch. The default, if not specified, is
ABCGHRU. Refer to z/OS DFSMS Managing Catalogs: Catalog Search Interface for more information..
Examples
This example shows a long listing
-lform 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
-dswitch. Note that only the partial (pseudo directory) is listed forUSER.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