This topic contains diagnosis, modification, and tuning information.
For control data sets, the AUDIT command detects, reports, diagnoses, and (in many cases) provides repairs for discrepancies within and between the migration control data set (MCDS); the backup control data set (BCDS); the offline control data set (OCDS); VTOCs of DASD volumes; TTOCs for DFSMShsm tape volumes; and the computer system catalogs, including the master catalog and user catalogs.
For common queues, the AUDIT command enables DFSMShsm to dynamically correct inconsistancies with minimal impact on processing. Common queues have interrelated entries that may become corrupted due to abends and unexpected losses of connectivity. A corrupted common queue may cause certain requests to not be processed. DFSMShsm automatically corrects some inconsistencies, but for others, it is necessary to issue the AUDIT COMMONQUEUE command.
These topics can help you make the best use of the AUDIT command for your application. In topics one and two, for each of the AUDIT options, we describe the checking done, and which error conditions can be detected by using that option. For each reported condition, AUDIT may be able to determine a repair action. The actual form of the repair commands, if any, depends on the control information involved.
The options described in Using the enhanced audit command to audit DFSMShsm control information are enhancements to the original AUDIT command described in Using the original AUDIT command to audit DFSMShsm data set information. Table 1 compares the information driving the AUDIT options.
| Driving Information | Enhanced AUDIT Option | Original AUDIT Option |
|---|---|---|
| Aggregate backup records | ABARSCONTROLS | None |
| Copy pool records | COPYPOOLCONTROLS(cpname) | None |
| Specific data set names | None | DATASETNAMES |
| Catalog entries | None | MASTERCATALOG |
| Backup Control Data Set | DATASETCONTROLS(BACKUP) | BCDS |
| Migration Control Data Set | DATASETCONTROLS(MIGRATION) | MCDS |
| Tape table of contents (ML2 volume) | DIRECTORYCONTROLS | VOLUMES |
| Tape table of contents (backup volume) | DIRECTORYCONTROLS | BACKUPVOLUMES |
| Volume table of contents (DASD VTOC) | DIRECTORYCONTROLS | VOLUMES |
| DFSMShsm images of user data sets | MEDIACONTROLS |
None |
| Backup-volume records | VOLUMECONTROLS(BACKUP) | None |
| Common queues | COMMONQUEUE | None |
| Migration-volume records | VOLUMECONTROLS(MIGRATION) | None |
| Eligible-volume records | VOLUMECONTROLS(RECOVERABLE) | None |
Error codes (*ERR) and diagnosis describes all the conditions reported by AUDIT, as well as repair actions taken and diagnostic suggestions for those cases where AUDIT cannot resolve a discrepancy.
Unexpected errors during an audit identifies errors that may occur to prevent AUDIT from completing its checking.
Other considerations when using the AUDIT command presents considerations for using AUDIT in a multiple-DFSMShsm-host environment and suggestions for printing output.