Table of Contents (exploded view)
Abstract for DFSMS Object Access Method Planning, Installation, and Storage Administration Guide for Tape Libraries
Summary of changes
Changes for SC23-6867-01 z/OS Version 2 Release 2
Changes for SC23-6867-00 z/OS Version 2 Release 1
Summary of changes for z/OS Version 2 Release 1
Introduction to tape library management
Automated tape storage
Automated tape library dataserver (ATLDS)
Manual tape storage
Manual tape library (MTL)
Object access method support for tape libraries
ISMF role with tape libraries
Installation storage management policy overview
System groups in an SMS configuration
Storage groups and automated class selections routines
Understanding the pre-ACS routine exit
Integrated catalog facility (ICF) and the tape configuration database
RACF considerations for the VOLCAT
Allocation Considerations with the VOLCAT
MVS hardware configuration definition
Types of tape volumes
Private tape management
Scratch tape management
Scratch tape management in an MTL
VTS stacked tape management
VTS outboard policy management
Duplicate volume management
TotalStorage Automated Tape Library (3495) system attachment
High capacity input and output facility
External high-capacity input and output facility
Manual mode terminal
Library manager application
Convenience input and output facility
TotalStorage Automated Tape Library (3494) system attachment
Cartridge storage cells
Tape systems
Convenience input and output station
High capacity input/output facility
Library manager application
System Storage Automated Tape Library (3584) system attachment
Integrated library manager
Virtual tape server (3494) system of the ATLDS
Emulating 3490-type virtual tape devices
Emulating 3490-type virtual volumes
Larger logical volume sizes
VTS system import and export functions
Tape volume cache
Storage management of the tape volume cache
Improved cache management
Deleting expired virtual tape server logical volume data
Secure data erase
Maintaining data fragments from migrated volumes
Fast response for nonspecific mount requests
Using the 3590 and 3592 storage capacity
Logical library partitioning
Operator interface
Logical volume inventory
Physical volume pooling
Selective dual copy
Bulk Volume Information Retrieval (BVIR) facility
Peer-to-Peer Virtual Tape Server (3494)
Geographically dispersed parallel sysplex support for peer-to-peer VTS
Selective peer-to-peer copy mode
Selective peer-to-peer dual copy
TS7700 Virtualization Engine
TS7740 Virtualization Engine (3957-V0x)
TS7720 Virtualization Engine (3957-VEx)
Logical WORM considerations
Copy mode options
TS7700 library operational states
TS7680 tape virtualization
Cache management
Load balancing
Entering a tape cartridge into a tape library
Cartridge entry processing without an online device
Importing logical volumes into a 3494 VTS system
Canceling an import operation
Import status messages
Importing a single logical volume at the library manager
Checking the volume serial number for uniqueness
Using global resource serialization with cartridge entry processing
Using global resource serialization in a manual tape library
Tape volume requirements
Accessing the tape volumes
Volume serial number restrictions
Ejecting a tape cartridge from a tape library
Ejecting a logical Volume from a VTS
Exporting logical volumes from a 3494 VTS system
Canceling an export operation
Export status messages
Copy export from the TS7700 Virtualization Engine
Host implications
Copy export merge
Using global resource serialization with export processing
Planning for the tape library support
Analyzing your hardware environment
Hardware
WORM considerations
Manual tape library hardware considerations
Managing multiple media formats
Tape device selection information
Demand allocation with system-managed tape
Load balancing considerations
Scratch allocations
Specific allocations
Balanced mode in the TS7700 Virtualization Engine
Specific allocation assistance
Scratch allocation assistance
JES3 considerations
Specific allocation assistance enablement considerations
Scratch allocation assistance enablement considerations
INISH deck example
Tape encryption support
Performance scaling considerations
Performance segmentation considerations
Using the tape configuration database (TCDB) to manage tape volumes
Software volume categories
Scratch threshold setting and scratch allocation implications
TCDB volume error status field and software error category in an automated tape library
Detecting software errors for private volumes
Detecting hardware errors for volumes
Resetting the volume error status field
Displaying scratch volume counts
Displaying software error category count
TCDB volume error status field and the MTL
TCDB volume expiration date
Console name message routing
Associating console names with tape libraries
Defining an alternate z/OS MCS console
Taking advantage of console name message routing
Sharing a tape library among multiple systems
Managing private volumes in a library sharing environment
Partitioning tape libraries among multiple sysplexes (systems)
Changing the library manager category assignments in an ATLDS
Processing default categories when using DEVSUPxx in an ATLDS
Separating the volumes for use in different TCDBplexes
Handling tape drives in a partitioned ATLDS
Handling tape drives in a partitioned MTL
Ability to use MTL drives as stand-alone
Sharing tape volumes between an SMSplex and a non-MVS platform
DFSMSrmm support for sharing a tape library dataserver
Installing your tape library support
Verifying prerequisites
Manual tape library considerations
TDSI coexistence considerations
Encryption-capable 3592 Model E07 coexistence considerations
Considerations when running z/OS as a guest under z/VM
Tape library installation checklist
Installation procedures
Building the library inventory
Changing system libraries
SETTLIB statement for tape library settings
ONLYIF statements in a PLEX
Updating the PROCLIB
Creating the global resource serialization environment
Creating the tape configuration database
Creating the hardware configuration
IPLing the system
Creating the SMS definitions
Creating the installation exit routines
Validating the configuration
Activating the SMS configuration
Starting the OAM address space
Varying the library online
Displaying and setting the cartridge loader media type
Running the job stream
Outboard policy management installation recommendations
Outboard policy management test environments
Outboard policy management migration and expected actions
Tape subsystem (device pool) limitation
Library subsystem modifications
Adding subsystems to a library
Moving subsystems within a library
Deleting subsystems from a library
Defining and monitoring your configuration
Monitoring and maintaining the tape configuration
Typical library management functions
Defining tape libraries
Altering the tape library definition
Managing the tape volume
Auditing the tape library volume in an ATLDS
Altering the tape volume record
Ejecting the tape volume with the EJECT line operator
Monitoring and maintaining SMS library definitions
Changing z/OS construct definitions
Outboard policy management definitions
Maintaining tape storage group definitions
Changing ACS routines
Establishing recovery procedures
Recovering volume catalogs
Recreating library entries
Recreating volume entries
Disaster recovery site considerations
Selective write protect for disaster recovery (DR) test
FlashCopy for disaster recovery (DR) test
TCDB procedure for retrieving data from a disabled IBM automated tape library
Altering private tape configuration database records
Changing from SMS-managed to non-SMS-managed requests
Changing the use attribute of scratch volumes
Using the sample exit for volume not in library (CBRUXVNL)
Library manager database volume list
Returning the library manager to an operational status
Operating the OAM address space
Overview of operator tasks
Message format conventions
Starting OAM
Varying a tape library online or offline
Restarting OAM
Varying tape drives online or offline
Ejecting a specific Tape Volume
Specifying the shelf location
Auditing a volume
Entering a tape volume into an MTL
Importing tape volumes into a VTS
Exporting tape volumes from a VTS
Requesting information from the TS7700 Virtualization Engine
Required parameters
Optional parameters
Disabling installation exit processing
Reenabling installation exit processing
Displaying the cartridge loader scratch media type
Setting the cartridge loader scratch media type
Assigning categories to ATLDS cartridge loaders
Assigning media types to MTL cartridge loaders
Media selection in an ATLDS
Media selection in an MTL
Assigning policy names outboard
Required parameters
Optional parameters
Construct validity checking
Displaying OAM status
Displaying SETTLIB parameters
Displaying library status
Displaying library connectivity
Displaying library detail status
Displaying tape drive status
Displaying storage group status
Displaying tape volume status
Displaying outstanding OAM messages
Stopping OAM
Capturing OAM diagnostic data
Querying active and waiting OAM tape library requests
Querying device services library information (DEVSERV QLIB)
Library control system (LCS) external services
LCS external services overview
Change use attribute (CUA)
Manual cartridge entry (MCE)
Cartridge eject (EJECT)
Query volume residence (QVR)
Test volume eligibility (TVE)
Export logical volumes (EXPORT)
Import logical volumes (IMPORT)
Peer-to-Peer mode control (PTPMC)
Peer-to-Peer data (PTPDATA)
Obtain library name information (OLN)
LCS external services functions
Changing the use attribute of a volume
Required parameters
Optional parameters
Successful change use attribute processing
Changing the use attribute from SCRATCH to PRIVATE
Changing the use attribute from PRIVATE to SCRATCH
Changing the use attribute of a WORM tape volume
Changing to the same use attribute
Setting policy names outboard using keywords
Return and reason codes for CBRXLCS change use attribute
Entering cartridges into a manual tape library
Parameter descriptions
Processing the tape device selection information (TDSI)
Return and reason codes for CBRXLCS manual cartridge entry
Ejecting a tape cartridge
Parameter descriptions
Successful EJECT processing
Return and reason codes for CBRXLCS eject
Return and reason codes for CBRXLCS eject query
Querying the residence of a volume
Parameter descriptions
Successful query volume residence processing
TS7700 Virtualization Engine programming considerations
Return and reason codes for CBRXLCS query volume residence
Testing the eligibility of a volume
Parameter descriptions
Successful test volume eligibility processing
Return codes for CBRXLCS test volume eligibility
Exporting logical volumes from a VTS
Required parameters
Optional parameters
Export processing requirements
Return codes for CBRXLCS EXPORT
Importing logical volumes into a VTS
Required parameters
Optional parameters
Import processing requirements
Return codes for CBRXLCS IMPORT
Changing library operating modes (peer-to-peer VTS mode control)
Required parameters
Optional parameters
Return codes for CBRXLCS PTPMC
Obtaining operational mode settings (peer-to-peer VTS data)
Required parameters
Optional parameters
Return and reason codes for CBRXLCS PTPMC
Obtaining library name information (OLN)
Required parameters
Successful obtain library name information processing
Return and reason codes for CBRXLCS OLN
CBRXLCS macro interface
Using the CBRXLCS macro in an assembler environment
CBRXLCS return codes
CBRXLCS execution environment
LCS external services parameter list (CBRLCSPL macro)
Tape data information (CBRTDI macro)
Tape volume information (CBRTVI macro)
Tape device selection information (CBRTDSI macro)
Installation exits
Change use attribute installation exit (CBRUXCUA)
Outboard policy management considerations
Job processing considerations
Change use attribute installation exit parameter list (CBRUXCPL)
Change use attribute installation exit (CBRUXCUA) return codes
Change use attribute installation exit (CBRUXCUA) usage requirements
Cartridge entry installation exit (CBRUXENT)
Outboard policy management processing when calling the entry exit
Outboard policy management processing when returning from the entry exit
Cartridge entry installation exit parameter list (CBRUXEPL)
Cartridge entry installation exit (CBRUXENT) return codes
Cartridge entry installation exit (CBRUXENT) usage requirements
Cartridge eject installation exit (CBRUXEJC)
Failed eject notification processing
Export completion processing
Cartridge eject installation exit parameter list (CBRUXJPL)
Cartridge eject installation exit (CBRUXEJC) return codes
Cartridge eject installation exit (CBRUXEJC) usage requirements
Volume not in library installation exit (CBRUXVNL)
Invoking the installation exit
Processing options for the installation exit
Logical volume considerations
Entering tape volumes in the library using the installation exit
Possible error conditions
Job step setup
Device allocation
Library mount processing
Volume not in library installation exit parameter list (CBRUXNPL)
Volume not in library installation exit (CBRUXVNL) return codes for job step processing
Volume not in library installation exit (CBRUXVNL) return codes for device allocation
Volume not in library installation exit (CBRUXVNL) return codes for library mount processing
Volume not in library installation exit (CBRUXVNL) usage requirements
SAMPLIB members
SAMPLIB member CBRSPLCS
SAMPLIB member CBRSPUXC
SAMPLIB member CBRSPUXE
SAMPLIB member CBRSPUXJ
SAMPLIB member CBRSPUXV
SAMPLIB member CBRAPROC
SAMPLIB member CBRSPSIM
SAMPLIB member CBRSPPIM
SAMPLIB member CBRSPPIP
SAMPLIB member CBRSPSXP
SAMPLIB member CBRSPPXP
SAMPLIB member CBRSPX03
Using ISMF panels to define and monitor your configuration
ISMF for the storage administrator
Defining a tape library
Displaying tape library attributes
Redefining a tape library
Altering a tape library
Copying tape library definitions
Identifying the from and to sources for copying
Deleting a tape library definition
Monitoring and maintaining tape volumes
ISMF mountable tape volume application
Generating a Mountable Tape Volume list
Final step: generating the list
Creating a list of tape libraries
Viewing and sorting a list
Auditing volumes in an automated tape library
Verifying external volume labels using the ATLDS vision system
Verifying VTS logical volume entries in the library manager
Verifying volumes in a 3584 Tape Library
Using the AUDIT command or line operator
Receiving AUDIT completion messages
Identifying audit discrepancies
Detecting software errors
Altering the volume record
Using the ALTER command or line operator
Adding values to the tape volume information
Changing values associated with a tape volume
Validating new values through ISMF
Detecting errors with new values
Confirming an alter request
Changing the use attribute from private to scratch
Changing the use attribute from scratch to private
Ejecting a volume from a tape library
Specifying optional EJECT line operator parameters