Verifying optical volumes using audit

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.

Tip: You also can use the MODIFY OAM,AUDIT,VOLUME command to audit a volume. See Auditing a volume for more information.

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.)

AUDIT functions help you ascertain the physical location of optical volumes by verifying whether or not a library volume resides in the location that is listed for that volume in the optical library outboard inventory. The library controller maintains the internal library location of the cartridges in the outboard inventory. The host also identifies which library contains each cartridge in the volume table. If the host record or records do not match the controller inventory when OAM performs an audit, then you must correct the records, the inventory, or both. The AUDIT functions do not perform any corrective actions; their purpose is verification only. See Remapping an optical library for a description of corrective actions that you can take if the audit is unsuccessful.

Note:

The AUDIT function is available for the 3995 with the exception of the 3995-C3A models and pseudo optical libraries.
AUDIT functions only process volumes that are known to OAM. If an unknown volume is in the library, the AUDIT functions do not detect this condition. REMAP functions are necessary to locate and eject the unknown volume.
AUDIT functions from the host application and the 3995 dynamic console are not the same. In a z/OS installation, the AUDIT function that is available from the 3995 dynamic console is intended for use during hardware service; AUDIT functions that are issued from the 3995 dynamic console do not communicate with OAM at the host. The AUDIT function from the 3995 dynamic console performs the same hardware function as a library REMAP. In a z/OS installation, issue the AUDIT functions from the host application and not from the 3995 dynamic console; otherwise, the host and the library controller can differ. This manual describes only the command functions available from the host application through ISMF Library and Volume applications and z/OS operator commands.
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.

ISMF AUDIT provides three scopes:

Single volume audit (AUDIT line operator)
Volume list audit (AUDIT command)
Full library audit (AUDIT line operator)

For each volume audited, three conditions must be present:

Volume must be obtained from its assigned storage slot.
Volume must be mounted.
Internal label of the volume must be read and verified as matching the entry for that storage slot/volume combination in the outboard inventory.

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.

Table 1. Auditing results that appear in the VOLUME ERROR STATUS column
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.

Note: You cannot audit optical volumes that are on a shelf.

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.

Figure 1. Confirm Optical Volume Audit 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.