AUDIT can be invoked as an ISMF line operator on the Mountable Optical Volume List panel (Single Volume AUDIT) or the Optical Library List panel (Full Library AUDIT). The storage administrator uses the AUDIT line operator to verify the physical location of an optical volume. The audit compares the volume information maintained in the OAM configuration database and the optical library outboard inventory with the actual location of the optical volume. AUDIT does not just compare the OAM configuration database with the outboard inventory; it actually causes the volume to be mounted and reads the volume serial number to verify that the volume is in its assigned storage location.
When you invoke the AUDIT line operator successfully, AUDIT SCHEDULED is displayed on the Mountable Optical Volume list. If the volume is successfully scheduled for an audit, the volume has *AUDIT displayed in the line operator column. Audits that are not successfully scheduled have ¬AUDIT or ?AUDIT in the line operator column. ISMF also displays a short message explaining why the audit is not scheduled (see Table 2 for more information).
AUDIT can also be invoked as an ISMF command to audit all the eligible optical volumes on the Mountable Optical Volume List (Volume List AUDIT). ISMF is an important part of the AUDIT scheme because it allows you to start with an entire optical volume list, and by using sorting and filtering capabilities, you reduce that list to a subset of volumes; for example, all the volumes in storage group x. You can then use the AUDIT command to request an audit of all volumes in that subset list. (The AUDIT command does not affect volumes that you have hidden using the HIDE line operator.)
You can find further information about commands from the 3995 dynamic console in the 3995 Model 153, 151 Operator Guide or the 3995 Operator Guide for C-Series Models.
When you receive an audit completion message, you can use the REFRESH command to update the Mountable Optical Volume list with the same selection criteria. The results of the audit are shown in the VOLUME ERROR STATUS column and you also receive a message with the error results. If you log off before the results are obtained, messages are stored in the users broadcast data set and displayed during the next logon process. VOLUME ERROR STATUS contains only the last error found; no history is kept. No attempts are made to fix the problems at the time of detection because, based on the error found, the software is unable to determine exactly what the corrective action should be. Use REMAP, discussed in Remapping an optical library, to correct the problems. Table 1 lists possible results of auditing an optical volume.
Result | Meaning |
---|---|
NO ERROR | Either no error occurs during the audit, or shows the initial status of the VOLUME ERROR STATUS column. |
NOT IN THE LIBRARY | The volume has an entry in the OAM configuration database, but no corresponding entry in the outboard inventory. |
VOLUME NOT FOUND | The volume was not found in its assigned storage slot. Either the slot is empty or another volume was found. |
VOLUME IN WRONG SLOT | This volume was found while auditing another volume or when attempting to mount another volume. |
MEDIA ERROR | An error occurred when the volume serial number was read. |
When you request an AUDIT, you must specify all volsers to be audited, even if two of the volsers represent opposite sides of the same cartridge. When you specify a full library AUDIT using the AUDIT line operator, all volume serial numbers listed in the host inventory as residing in that library are audited.
Whenever a full library AUDIT or a volume list AUDIT is requested, a confirmation panel is displayed. This panel gives you the opportunity to confirm or deny the audit request. To confirm, type in Y, then press ENTER. See Figure 1 for the Confirm Audit Request panel.
Panel Utilities Help
------------------------------------------------------------------------------
CONFIRM AUDIT REQUEST
Command ===>
Number of Volumes to be Audited: 97
Specify the Following:
Enter "/" to select option Perform Audit
Note: If Audit is Performed, Audit Requests will be Interspersed with other
Requests, with the Audit Request having low priority.
Use ENTER to Perform Operation;
Use HELP Command for Help; Use END Command to Exit.
When you receive an audit completion message, you can use the REFRESH command to update the Mountable Optical Volume List with the same selection criteria. The results of the audit are shown in the VOLUME ERROR STATUS column, discussed in Table 1. If you log off before completion, resulting messages are stored in your broadcast data set and displayed at the next logon.
For information concerning using the AUDIT line operator with tape libraries, see z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries.