Limiting the Scope of DIAGNOSE

You can specify which records are to be analyzed, or you can exclude certain records from analysis. In this way, you can limit the analysis to records you suspect are in error. If you are analyzing a VVDS, you can also focus on particular catalogs, including or excluding VVDS records belonging to certain catalogs.

This is done using the INCLUDE or EXCLUDE parameters:

INCLUDE—check only those entries meeting the specification
EXCLUDE—check the complement of the entries meeting the specification.

Although INCLUDE and EXCLUDE define the scope of the catalog analysis, some entries that are not to be checked may need to be scanned during the processing of the command. Errors in scanned records may result in messages, even though the entries were not to be checked.

Table 1 outlines what happens in processing when INCLUDE and EXCLUDE are specified with DIAGNOSE.

Table 1. DIAGNOSE Processing When INCLUDE or EXCLUDE are Specified
Data Set Type	Normal Processing	INCLUDE Processing	EXCLUDE Processing
VSAM cluster	Cluster and all components and paths	VSAM cluster and components but no paths	VSAM cluster and components but no paths
VSAM component	Cluster and all components and paths	Only the component	Only the component
VSAM path	Path and related alternate index or base cluster	Only the path entry	Only the path entry
non-VSAM	Entry and any aliases	Entry only	Entry only
non-VSAM alias	Alias and the base entry	Alias entry only	Alias entry only
generation data group base	generation data group base, generation data sets, and aliases	generation data group base and generation data sets	generation data group base and generation data sets
generation data set	generation data group base, generation data sets, and aliases	generation data set only	generation data set only

You can change the GDG setting for reclaim processing as needed without having to IPL the system by specifying the keyword setting for GDS_RECLAIM(NO) in the IGDSMSxx member of SYS1.PARMLIB. If GDG reclaim processing is not desired the default is GDS_RECLAIM(YES). You can also issue the SETSMSGDG_RECLAIM(YES|NO) command to change the value specified in the IGDSMSxx member of SYS1.PARMLIB. This change is in effect only until you re-issue the command or IPL the system.