Basic System DMS PROC › SELECT Command › DSCL SELECT CRITERIA Field Name Descriptions › CATSTAT — Catalog status of the data set

CATSTAT — Catalog status of the data set

This field should be used only when running SCAN REALVOLS. The second operand in a CATSTAT comparison can be any of the following:

YES/TRUE/ON

Data set is properly cataloged.

NO/FALSE/OFF

Data set is not cataloged (except CATOTHER or WRONGVOL).

WRONGVOL

Data set is cataloged, but to a different volume.

CATOTHER

Catalog status cannot be determined for the data set due to an error, such as the volume with the catalog is not online.

For example, to select non-cataloged and miss-cataloged data sets, use:

SELECT CRITERIA=(CATSTAT,NE,YES)

Data sets with a CATOTHER status are never selected unless (CATSTAT,EQ,CATOTHER) is specified. This ensures that if a catalog is damaged or offline, data sets are not selected by any other combinations of the CATSTAT values. Sysres data sets that are catalogued to alternate sysres packs and show a value of ****** or &vvvvv in the volume field of an IDCAMS List Catalog are considered incorrectly catalogued and will be selected when using the NE operand in the criteria statement unless the WRONGVOL parameter is also coded.

For example, if the following statement is used to process data sets on a Sysres volume which contains data sets catalogued to an alternate sysres pack, all data sets with the ****** or &vvvvv value are selected as well as all of the un-cataloged data sets.

SELECT CRITERIA=(CATSTAT,NE,YES)

However, if the WRONGVOL parameter is also used, as shown in the next example, only the un-cataloged data sets are selected.

SELECT CRITERIA=(CATSTAT,NE,YES,AND,CATSTAT,NE,WRONGVOL)

Note: If you are not running a report that requires the catalog status to be checked, specifying this criterion can cause a significant increase in both elapsed and CPU times (since the catalog is checked for every data set).