DIAGNOSE BCS-VVDS

Use the DIAGNOSE BCS-VVDS command to compare the contents of one or more user catalogs (BCSs) against associated VVDSs.

The input BCS(s) drive the processing. Details of each BCS record containing a volume cell are noted. Following the extraction of BCS data, the relevant VVDS and VTOC information is obtained. The diagnosis is done comparing the BCS data against the combined VVDS and VTOC data, looking for inconsistencies.

Syntax

Read syntax diagramSkip visual syntax diagramDIAGnose BCS-VVDS ( Compare-BCS(,bcsbcsmask)Accept-Examine(W)Accept-Examine(WDEI)AGE-tolerance(1)AGE-tolerance(10nnnnNO)ALL-RelatedTo-STorageGrouP(,stgrpstgrpmask)TO-VVDS(,volservolsermask)To-STorageGrouP(,stgrpstgrpmask)TO-VVDS(,volservolsermask)DELete-EntriesEXAMine(DataTEST IndexTEST)EXAMine(DataTEST IndexTESTIndexTESTNOIndexTESTDataTESTNODataTESTNOEXAmine)EXAMine-error-LIMit(16)EXAMine-error-LIMit(16nnnn)1EXClude-Bcs(,bcsbcsmask)EXClude-Storagegroup(,stgrpstgrpmask)EXClude-Vvds(,volservolsermask)INClude-Dsn(,dsndsnmask)EXClude-Dsn(,dsndsnmask)FIXES,(FIXDataSet( dsn) MemBeR( mbr)FixFILE( ddname)MemBeR( mbr)CLASS(*)CLASS(*00010203pair))MAP-report(BcsBCS-VOLVOL-BCSVOL)Master-CATalog( mcat)MeSsaGe-TeXT(NONE)MeSsaGe-TeXT(NONEFULL)Multi-Level-Alias( n))
Notes:
  • 1 This keyword is valid only if specified with EXAMINE (DATATEST) or EXAMINE (INDEXTEST).

DIAGNOSE BCS-VVDS Command Syntax

Keywords

COMPARE-BCS
specifies one or more fully qualified or masked BCSs to process. Every catalog entry in each selected BCS will be checked against its associated VVDS. Anomalies will cause one or more fixes to be generated.
ACCEPT-EXAMINE
controls whether to continue processing the current BCS based on the condition code returned by the EXAMINE keyword. If either DATATEST or INDEXTEST is specified on the EXAMINE keyword, then DIAGNOSE BCS-VVDS will execute an IDCAMS EXAMINE command. The IDCAMS EXAMINE may terminate with a condition code of 0, 4, 8, or 12.
The valid values for ACCEPT-EXAMINE are:
  • W—allows the diagnose to continue when warning messages (IDCAMS RC=4 or less) are issued. This is the default.
  • D—allows the diagnose to continue when disaster level, or extremely serious error messages (IDCAMS RC=12 or less) are issued.
  • E—allows the diagnose to continue when error messages (IDCAMS RC=8 or less) are issued.
  • I—allows the diagnose to continue when informational messages (IDCAMS RC=0) are issued.
ACCEPT-EXAMINE is valid only if specified with EXAMINE (DATATEST) or EXAMINE (INDEXTEST).
AGE-TOLERANCE
specifies that the diagnosis is to ignore catalog entries that have been created in the last n number of days. You can enter a value of up to 4 numeric characters.
ALL-RELATED
specifies the most comprehensive diagnosis and will identify the target VVDSs by analyzing the Volume cells within every BCS record.
TO-STORAGEGROUP
specifies one or more fully qualified or masked DASD storage groups to search and determine if there is an associated VVR (for VSAM) or NVR (for non-VSAM) record to participate in the diagnose compare process.
TO-VVDS
specifies one or more fully qualified or masked volume serial numbers to search and determine if there is an associated VVR (for VSAM) or NVR (for non-VSAM) record to participate in the diagnose compare process.
DELETE-ENTRIES
indicates that the generated IDCAMS DELETE fix commands should not be commented out with the ‘/*’ prefix. This allows the fixes to run without modification.
EXAMINE
indicates that an IDCAMS EXAMINE command will be invoked for the BCS prior to performing the diagnostic comparison with the VVDS.
INDEXTEST
specifies that a complete analysis of the BCS's index component structure is to be performed. A crosscheck is made of the vertical and horizontal address pointers between all of the index's records, an analysis of the internal structure of the index CIs is made, and an analysis of the internal structure of the index record is performed. INDEXTEST is an AMS EXAMINE option.
NOINDEXTEST
specified in conjunction with DATATEST indicates that no analysis is performed on the index component.
DATATEST
specifies that a complete analysis of the BCS's data component structure is to be performed. A complete sequential read of the BCS's data component records is performed, using the index component's sequence set records, reading all CIs, including those marked free. Tests are done using each CI's RDFs and the CIDF, to ensure that the information about free space record numbers, lengths, and locations is correct. DATATEST is an AMS EXAMINE option. Specifying DATATEST automatically includes an INDEXTEST.
NODATATEST
indicates that no analysis is performed on the data component.
NOEXAMINE
indicates that an IDCAMS EXAMINE command is not to be invoked prior to diagnostic comparison.
EXAMINE-ERROR-LIMIT
specifies the maximum number of errors to identify by the IDCAMS EXAMINE command. If you do not specify a value for EXAMINE-ERROR-LIMIT, it defaults to 16. If a value is specified, it must be numeric and within the range of 0 (zero) to 2,147,483,647.
EXCLUDE-BCS
specifies one or more fully qualified or masked BCSs to exclude from processing.
EXCLUDE-STORAGEGROUP
specifies one or more fully qualified or masked storage group names to exclude from processing.
EXCLUDE-VVDS
specifies one or more fully qualified or masked volsers to exclude from processing.
INCLUDE-DSN
specifies one or more fully qualified or masked data set names to process.
EXCLUDE-DSN
specifies one or more fully qualified or masked data set names to exclude from processing.
FIXES
specifies that the DIAGNOSE command should create the appropriate IDCAMS fix commands for certain errors that are identified.
FIXDATASET
specifies the fully qualified name of the pre-allocated output data set for the generated IDCAMS control statements required to fix the BCSs.
FIXFILE
specifies the Data Definition name (DD name) to be used to allocate the output file to contain the fixes. You must specify this keyword if one of the following is true:
  • The output fixes data set is a Generation Data Set (GDS) and you wish to specify a relative GDG.
  • You want to control the DISPOSITION of the data set, or change the generated JCL to, for example, output the fixes to SYSOUT.
MEMBER
specifies the member name of the data set where the generated fixes will be stored. If the data set specified is a PDS or PDSE and no MEMBER is specified, then the member name used will be TEMPNAME.
CLASS
specifies the class of the fixes to be generated and written to the output data set. The fixes generated depend on the type of problem encountered. If a CLASS is specified, but no FIXDATASET or FIXFILE is specified, then that specific class of errors will be reported, but no fixes generated.
You must specify one of the following values:
  • * — all errors generate a fix.
  • 00 — the error is ambiguous so no fix is attempted.
  • 01 — the error is unambiguous and clearly correctable so a fix is generated.
  • 02 — the error is probably correctable so a fix is generated. These fixes will require review and verification.
  • 03 — the error requires that the fixes be closely checked and may require modification.
  • pair — the error matches the low-high pair value (for example, 01:03) so a fix is generated.
MAP-REPORT
specifies the type of BCS-VVDS mapping report to be generated. If you specify MAP-REPORT, you must specify at least one of the following values:
  • VOL—error and fix counts reported by volser.
  • BCS—error and fix counts reported by BCS name.
  • BCS-VOL—error and fix counts reported by volser within BCS name.
  • VOL-BCS—error and fix counts reported by BCS name within volser.
MASTER-CATALOG
identifies a valid alternate master catalog from which to locate user catalogs. The master catalog that you specify must be connected to the current system's master catalog.
MESSAGE-TEXT
controls the volume of IDCAMS messages printed during the diagnose. The valid values are:
  • FULL—indicates that all IDCAMS EXAMINE messages are to be displayed.
  • NONE—indicates that all IDCAMS EXAMINE messages are to be suppressed.
MULTI-LEVEL-ALIAS
specifies the MLA value to be used when analyzing BCS usage for any given catalog data set entry. The value must be numeric between 1- 4 inclusive. If this keyword is not specified, the current system value will be used.

Usage notes

The DIAGNOSE BCS-VVDS command syntax shows the keyword and option defaults that are provided at installation time. You can change many of these keyword and option defaults by modifying their associated tokens in the DIAG_BCS_VVDS_OPTIONS section of the CKMINI member of SCKMPARM.