OAM keeps an inventory of the optical volumes in the OAM configuration database (OCDB). At the same time, the controller in the IBM 3995 optical library maintains an inventory of the optical volumes, which is called the outboard inventory. Usually these two volume inventories match, but there are some unusual conditions where they might go out of synchronization. Use the library audit and remap functions to synchronize the volume inventories in the OCDB and outboard inventory.
If audits or other functions indicate volume locations are incorrect, you can use the REMAP line operator to reconstruct the optical library’s outboard inventory, by verifying the identity of each volume in the optical library.
REMAP also detects and corrects any discrepancies between the outboard inventory and the volume table in the OAM configuration database. The REMAP line operator is not available for tape libraries.
You also can use the MODIFY OAM,REMAP operator command to remap an optical library. See Remapping an optical library for more information on the syntax and parameters for this command.
If these checks are successful, the REMAP Confirmation panel is displayed, asking you to confirm the REMAP. To confirm, type in "Y", then press ENTER. If the REMAP is accepted, the message REMAP SCHEDULED is displayed. Once the REMAP process is started, it must run to completion. There is no REMAP cancel function.
Recommendation: REMAP execution can take from 30 to 80 minutes to complete a full library depending on the number of online drives in the library. Therefore, when scheduling a REMAP, be sure to take work load and time factors into consideration. Also, once a REMAP is started, stopping OAM DOES NOT cancel REMAP processing. If you stop OAM in an attempt to cancel or stop a REMAP request, the library controller inventory must be rebuilt, and the REMAP continues to process in the library. There is no option of canceling a REMAP request once it is started.
When you issue a REMAP request for a library, all work in progress for the library is allowed to complete. However, new work requests and work requests scheduled but not yet started are rejected (except for drive vary requests that were queued prior to the REMAP request). Cartridges in the internal drives are demounted. If the library has an operator-accessible drive, upon completion of work in progress, the cartridge is demounted and the drive becomes unavailable for activity until the REMAP processing is complete. If an internal drive cartridge demount fails, REMAP processing fails; however, if the demount fails on the operator-accessible drive, REMAP processing continues on the internal drives.
Once you issue REMAP, the library controller reconstructs its inventory by going to each slot in the library. It verifies the identity of the cartridge in that slot by inserting that cartridge in a drive and reading both volume serial numbers. When the new inventory is complete, the host reads the inventory and compares all the inventory records with the volume records, and the volume records with the inventory. Updates are made to the appropriate host tables or the cartridge is ejected if the table cannot be corrected. Host volume records that indicate a volume is in the library but cannot be found in the outboard inventory are marked as shelf-resident and the volume status is updated as lost. All duplicate cartridges are marked by the library controller, causing the host to schedule the cartridge for eject. You are notified of the start of REMAP, all ejected cartridges, and of the completion of REMAP through a message to your TSO/E logon session.
When you receive a completion message, you can enter the LISTVOL line operator to display the Mountable Optical Volume List for all optical volumes in the remapped library. Check the VOLUME ERROR STATUS column, described in Table 1, for error messages issued for errors detected by the REMAP operation.
| Result | Meaning |
|---|---|
| NO ERROR | Either no error occurs during the REMAP, or shows the initial status of the VOLUME ERROR STATUS column. |
| LOST VOLUME | A record in the volume table indicates a volume is in the optical library, but the volume cannot be found in the outboard inventory for that optical library. |
The error messages are issued to the ISMF user who invoked the REMAP line operator. The messages contain the serial number (volser) of the volume for which the error was found and text indicating the type of error found. If you log off the TSO/E session before completion, the messages are stored in a broadcast data set and displayed the next time you log on. REMAP also might update the VOLUME LOCATION, VOLUME LIBRARY NAME, and MEDIA TYPE columns.