Monitoring and maintaining the tape configuration

ISMF makes it possible to monitor and maintain information associated with the tape configuration database, the source control data set, and the tape volumes that reside in automated and manual tape libraries.

Typical library management functions

The ISMF Library Management option allows you to generate lists of tape libraries and volumes, display the attributes of a tape library, alter definitions that were originally defined, add new definitions, audit tape libraries and tape volumes, and eject tape volumes from the tape library.

This section discusses the effects of some typical configuration maintenance tasks. See Using ISMF panels to define and monitor your configuration for information concerning the use of ISMF with tape libraries, and see z/OS DFSMS Using the Interactive Storage Management Facility for detailed information about using ISMF.

Defining tape libraries

The first time a tape library is defined, the storage administrator enters all the appropriate attribute definitions associated with the tape library being defined on the ISMF define panels. Once all the information is entered, an entry containing that information is added to the tape configuration database (TCDB). Also, a tape library definition is added to the specified source control data set (SCDS). For more detail concerning defining tape libraries using ISMF, see Defining a tape library.

When you attempt changes to the attribute definitions of an existing tape library, the information residing in the TCDB associated with the tape library is displayed through a Redefine panel. Changing any of the attributes previously defined results in an update to the TCDB and to the specified SCDS. For more information on redefining tape libraries, see Redefining a tape library.

Note: Only one SCDS can be activated at any time. Activating another SCDS or reactivating the current SCDS while OAM is running causes OAM to restart by default, unless RESTART=NO is specified in the OAM PROCLIB member. During this restart, all libraries are set to either online or offline according to the attributes defined in the SCDS. After the restart completes, display all libraries to verify that they are set to the desired operational state.

Altering the tape library definition

Altering a tape library definition results in an update to the corresponding library record in the TCDB and the SCDS. For more information on altering a tape library, see Altering a tape library.

Note: The altered library definition takes effect when the SCDS is activated and OAM is restarted.

Managing the tape volume

The ISMF Library Management function also assists in the maintenance and verification of the tape volumes within the tape library dataservers through the use of the Mountable Tape Volume Application available from the Tape Library Application Selection panel (option 1—LIST).

Note: If the TCDB is being shared across multiple system levels, volume records containing TDSI information that are not understood by the level of software on the system are not displayed when a volume list is requested from ISMF. This prevents the system from processing volume records containing TDSI information that is not understood by the system.
Using the Mountable Tape Volume Application, storage administrators can use line operators or ISMF commands to perform inventory tasks against tape libraries and tape volumes. The following functions can be performed using the Mountable Tape Volume Application:
  • AUDIT a volume, a list of volumes, or a tape library
    Note: The audit functions are not supported in an MTL.
  • ALTER the use attribute, storage group, shelf location, or owner information of a volume or list of volumes
  • EJECT a single tape volume

For more detail on the use of the Mountable Tape Volume Application, see ISMF mountable tape volume application.

Auditing the tape library volume in an ATLDS

The AUDIT function in an ATLDS helps you verify the physical location of tape volumes within the library. It verifies whether or not a library volume resides in the location listed for that volume in the library manager inventory. The volume records in the TCDB identify the libraries where the volumes reside. If the TCDB records do not match the library manager inventory when an audit is performed, the TCDB records, the inventory, or both, must be corrected. The AUDIT function does not perform any corrective actions; messages are issued and the volume error status field in each tape volume record is updated, but the purpose of the audit is verification only. For more information concerning auditing tape volumes with ISMF, see Auditing volumes in an automated tape library.

Note: In an environment with multiple systems at different software levels but sharing a common TCDB, library audits should be performed on the system with the highest software level. A library audit on a lower software level does not include higher release level volumes if there are media types unknown to the lower level software.

Altering the tape volume record

ISMF allows you to alter the use attribute, storage group, shelf location, and owner information of a single tape volume or a list of tape volumes through the use of the ALTER line operator or the ISMF ALTER command. These commands are used from the Mountable Tape Volume List panel (see Figure 1). For more detail regarding the ISMF alter commands, see Altering the volume record.

Ejecting the tape volume with the EJECT line operator

The EJECT line operator is used to eject a single library-resident volume from a tape library with the option of keeping or purging the associated tape volume record within the TCDB. The EJECT line operator command is used from the Mountable Tape Volume List application of ISMF. For more information concerning this line operator and the Mountable Tape Volume List, see Ejecting a volume from a tape library and Figure 1.