z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


LCS external services overview

z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries
SC23-6867-00

The executable macro CBRXLCS is used to invoke the LCS External Services to perform the following functions:
  • Change the use attribute of a volume
  • Enter one or more volumes into a manual tape library
  • Eject a tape cartridge from a tape library
  • Query the name and type of a tape library where a specified volume resides
  • Determine whether a tape volume can be mounted on a specific device
  • Export a list of logical volumes from a VTS
  • Import a list of logical volumes into a VTS
  • Change current operating modes of a Peer-to-Peer VTS library
  • Obtain operational mode settings and device-related information from a Peer-to-Peer VTS library
  • Obtain library name information
Note: You might have an environment with multiple systems at different levels sharing a common TCDB. In this event, if a system attempts to perform a CBRXLCS function against a volume that has a media type or recording technology that is not recognized, the request fails.

Change use attribute (CUA)

The change use attribute (CUA) function changes the status of the specified volume from PRIVATE to SCRATCH, SCRATCH to PRIVATE, PRIVATE to PRIVATE, or SCRATCH to SCRATCH, and updates the tape volume record in the TCDB. It also calls the change use attribute installation exit to allow the installation to approve or disapprove the change in the volume status and to set values for many of the fields in the volume record. See Change use attribute installation exit (CBRUXCUA).

Manual cartridge entry (MCE)

The manual cartridge entry (MCE) function allows the user to enter a list of one or more tape cartridges into a manual tape library. When the MCE function is invoked, a tape volume record is created or updated in the TCDB. MCE calls the cartridge entry installation exit to allow the installation to approve or disapprove the entry of the cartridge into the manual tape library, and to set values for many of the fields in the volume record. For more information regarding the cartridge entry installation exit, see Cartridge entry installation exit (CBRUXENT).

Cartridge eject (EJECT)

The cartridge eject (EJECT) function of the LCS External Services provides two major functions for tape cartridge ejects:
  • Can eject a tape volume from a tape library. The tape volume record in the TCDB may be kept or purged. The cartridge eject installation exit is also called to allow the installation to approve or disapprove the eject request. If the eject request fails after the installation exit is invoked, the exit can also specify that a second failed eject notification call be made to the exit. See Cartridge eject installation exit (CBRUXEJC) for more information regarding the cartridge eject installation exit.
  • Can determine the eject status of a tape volume. Use the QUERY option of the EJECT function to determine if a volume has an eject request pending on an OAM internal queue. This use of the EJECT function does not invoke the cartridge eject installation exit, as it is only a query. See Ejecting a tape cartridge for more information on this function.

Query volume residence (QVR)

The query volume residence (QVR) function allows the installation to query the residency and type of library in which a specified volume resides. It also returns the console name associated with the library, if one has been specified by the installation, and if requested, other available information about the volume from the TCDB and library manager inventory.

Additionally, QVR provides audit capabilities from a tape management system database, since QVR does not require the presence of a TCDB record to perform this audit. A tape management system can use this capability to verify its inventory against the TCDB and the library manager inventory. It can also be used to track and verify the library residency of volumes that are not managed in the TCDB, such as stacked volumes in a VTS. See Querying the residence of a volume.

Test volume eligibility (TVE)

The test volume eligibility (TVE) function verifies that the specified tape volume serial number can be mounted on the specified tape device. See Testing the eligibility of a volume.

Export logical volumes (EXPORT)

After the tape management system or customer utility has written the list of logical volumes to export on an export list volume (logical volume residing in the same library as the volumes to be exported), the export function can be used to identify the logical volumes to export and to initiate the export operation at the library. This interface can also be used to cancel an executing export operation. See Exporting logical volumes from a VTS.

Import logical volumes (IMPORT)

After the tape management system or customer utility has written the list of logical volumes to import on an import list volume (logical volume residing in the same library as the volumes to be imported), the import function can be used to identify the logical volumes to import and to initiate the import operation at the library. This interface can also be used to cancel an existing import operation. See Importing logical volumes into a VTS.

Peer-to-Peer mode control (PTPMC)

The Peer-to-Peer VTS mode control (PTPMC) function allows an installation or application to change current operating modes of the library. This CBRXLCS function is not supported by the TS7700 Virtualization Engine. If invoked, the PTPMC function fails with Return Code 12, Reason Code 322, 'Command rejected by the library'. See Changing library operating modes (peer-to-peer VTS mode control).

Peer-to-Peer data (PTPDATA)

The Peer-to-Peer VTS data (PTPDATA) function allows an installation or application to obtain operational mode settings and device-related information from the PTP VTS library. This CBRXLCS function is not supported by the TS7700 Virtualization Engine. If invoked, the PTPDATA function fails with Return Code 12, Reason Code 322, 'Command rejected by the library'. See Obtaining operational mode settings (peer-to-peer VTS data).

Obtain library name information (OLN)

The obtain library name information (OLN) function of the LCS External Services macro allows you to obtain the library name or library ID, the console name, an indication of whether outboard policy management is supported, and the library type. See Obtaining library name information (OLN).

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014