DIAGNOSE VVDS-VTOC

Syntax

Keywords

COMPARE-STORAGEGROUP

specifies one or more fully qualified or masked storage group names to process. Every VVR and NVR in each volume's VVDS will be checked against its associated VTOC entry.

COMPARE-VVDS

specifies one or more fully qualified or masked volume names to process. Every VVR and NVR in each volume's VVDS within the selected storage groups will be checked against its associated VTOC entry.

SIMULATE

specifies that you want to trial the diagnosis without actually performing it.

AUTOFIX

specifies that corrective updates to the VVDS and VTOC should be performed.

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 VVDSs to exclude from processing.

MESSAGE-TEXT

controls the volume of messages printed during the diagnosis. The valid values are:

• FULL—provides a complete process log of all actions taken by the DIAGNOSE command.
• ABBREVIATED—provides a summary report.

SCRATCH

controls what happens when a Format 1 DSCB does not have a corresponding VVR or NVR in the VVDS, and a default VVR or NVR cannot be created. If you specify the SIMULATE keyword, a report proposing that the DSCB be scratched will be generated. If you specify the AUTOFIX keyword, an IDCAMS DELETE VVR or DELETE NVR will be directly executed to update the VTOC.

Usage Notes

• The DIAGNOSE VVDS-VTOC 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_VVDS_VTOC_OPTIONS section of the CKMINI member of SCKMPARM.
• When SCRATCH(NO) is specified or defaulted to, DIAGNOSE VVDS-VTOC will recommend running DIAGNOSE VOLUME-BCS against the specific volume that is missing VVR or NVR records in the VVDS for data sets that are present in the VTOC. DIAGNOSE VOLUME-BCS interacts with the catalog entries in greater depth, and, provides more information and anomaly resolution options. The volumes that DIAGNOSE VOLUME-BCS is recommended for will be noted in the analysis summary report towards the end of the listing.
• When SCRATCH(YES) is specified, an SMS Non-VSAM data set that is missing the expected NVR will only be scratched if it is not cataloged to that volume. Otherwise, DIAGNOSE VVDS-VTOC will attempt to build a default NVR for it when possible. It should be noted that ALTER NONVSAM SYNC-NVR is better equipped to rebuild an NVR with greater accuracy.
• When SCRATCH(YES) is specified and a VSAM component is missing its VVR in the VVDS, the orphaned component will be scratched from the VTOC. However, it is recommended to instead run DIAGNOSE VOLUME-BCS against this volume.
• If a customer is using Advanced Backup and Recovery (ABR) product and wants to avoid having DIAGNOSE VVDS-VTOC report FDRABR.V* datasets as needing deletion (which they do not) they can add ABR to the SPACE_MANAGEMENT parameter within the ACM-OPTIONS of the CKMINI.

  Example: Space_Management= ABR HSM

  The ABR_MODEL_DSCB_PREFIX is honored in order for DIAGNOSE VVDS-VTOC to ignore ABR's model DSCBs.

  Note: This only works if the ABR model DSCB is on the correct volume per its name.

  That is, if FDRABR.Vaaaaaa is on volume bbbbbb, it will NOT be exempt from normal DIAGNOSE VTOC-VVDS processing – the ABR model DSCB on volume aaaaaa must be named FDRABR.Vaaaaaa (or whatever is specified in INI for ABR_MODEL_DSCB_PREFIX.)