Using the original AUDIT command to audit DFSMShsm data set information

This topic describes the AUDIT parameters used to detect and to report discrepancies in data set information recorded in DFSMShsm control data sets, the VTOCs identifying data sets, and catalogs.

When the FIX parameter is specified, AUDIT can correct certain errors.

In general, the primary options listed in this topic perform less extensive diagnosis than those listed in topic One. There is some overlap between the parameters in the two topics. You may want to refer to Using the enhanced audit command to audit DFSMShsm control information as you choose the AUDIT parameters that will best serve your needs.

Table 1 lists the original AUDIT commands audit and report errors within DFSMShsm controls and where to find more information.
Table 1. Original AUDIT Commands that Audit and Report Errors
If the command you are interested in is. . . Then see. . .
AUDIT DATASETNAMES and AUDIT LEVELS Using the AUDIT DATASETNAMES and AUDIT LEVELS commands
AUDIT VOLUMES Using the AUDIT VOLUMES command
AUDIT BACKUPVOLUMES and AUDIT BACKUPTYPE Using the AUDIT BACKUPVOLUMES and AUDIT BACKUPTYPE commands
AUDIT MASTERCATALOG and AUDIT USERCATALOG Using the AUDIT MASTERCATALOG and AUDIT USERCATALOG commands
AUDIT MIGRATIONCONTROLDATASET Using the AUDIT MIGRATIONCONTROLDATASET command
AUDIT BACKUPCONTROLDATASET Using the AUDIT BACKUPCONTROLDATASET command
AUDIT OFFLINECONTROLDATASET Using the AUDIT OFFLINECONTROLDATASET command
AUDIT ALL Equivalent to AUDIT MCDS, then AUDIT BCDS, then AUDIT OCDS(ALL).
The parameters specified in the AUDIT command determine which data sets are audited. SMS-managed data sets are processed similarly to the audit of non-SMS-managed data sets. You can audit:

Audit information is written to a SYSOUT or user specified data set, in tabular form, with each row representing the result for one data set. In most cases, you can request that the audit output, in a different format, be sent to the terminal from which the AUDIT command has been issued. However, large reports, such as AUDIT ALL, cannot be sent to the terminal.

Table 2 explains the information that can be reported for a data set.

Table 2. Headings of Output When You Audit Data Set Information
Printer Output Heading Terminal Label Description
ERROR TYPE ERROR TYPE **NONE under this heading specifies that no error has been found for the specified data set. *ERR nn specifies the error number detected for the data set.
DATA SET NAME DSN The entry under this heading is the name of the data set being audited.
AUDITED VOLUME AUDITED VOL This is the serial number of the primary, migration, or backup volume being audited.
DATA SET ON VOLUME DSN ON VOL A serial number under this heading is the serial number of the primary, migration, or backup volume that contains the data set being audited. In addition, a volume serial number indicates that the data set is cataloged. ?????? indicates that the existence of the data set on the volume indicated by the catalog could not be verified. If *ERR 16 or *ERR 17 occurs, this field can contain additional diagnostic information. See Error codes (*ERR) and diagnosis.
CATALOGED TO VOLUME CTLG VOL A serial number under this heading is the serial number of the volume where the data set resides as recorded in the catalog. MIGRAT indicates that the data set is on a migration volume. -NONE-indicates that no record of the data set exists in the catalog. OFFLNE indicates that the catalog could not be opened.
MIGRATED TO VOLUME MIG VOL A serial number under this heading is the serial number of the migration volume that contains the data set as recorded in the MCDS. RECALLED indicates that the data set is on a mounted primary volume as indicated in the MCDS. DELETED indicates that the data set has been deleted as indicated in the MCDS. -NONE-specifies that no record of the data set exists in the MCDS.
BACKED UP TO VOLUME BACK VOL A serial number under this heading is the serial number of the backup volume that contains the most recent backup version of the data set as recorded in the BCDS. -NONE-indicates that no BCDS backup version record has been found for the data set. (This is not an error if the data set is a VTOC copy data set or a VCAT copy data set, or if the data set resides on a DASD backup volume.)
DUPLICATE DSN ON VOLUME DUP DSN ON VOL If the catalog indicates that a data set of the same name resides on a volume other than the one being audited and that fact is verified, the serial number of the other volume is listed under this heading.
Note: All errors listed in AUDIT reports are described in Error codes (*ERR) and diagnosis.
Parent topic: Using the AUDIT command