Displaying tape library attributes

A storage administrator can display the attributes of a tape library dataserver by:

Select option 2, DISPLAY, on the Tape Library Application Selection panel (Figure 3).
Press ENTER.

Figure 1 shows the first of the two TAPE LIBRARY DISPLAY panels that are displayed.

Figure 1. Tape Library Display Panel (Page 1 of 2)

   Panel  Utilities  Scroll  Help
 ------------------------------------------------------------------------------
                               TAPE LIBRARY DISPLAY                 Page 1 of 2
 Command ===>_
 
 CDS Name . . . : SCDS.TEMP.PRIMARY
 Library Name . :LIB1          Device Type  . :3495-L50
 Library Type . :AUTOMATED     Library ID . . :0001C
 Description  . :Automated tape library 0001C in building 031
 
 
 Console Name  . . . . . . . :LIB1CON
 Entry Default Data Class  . :DCATLDS
 Entry Default Use Attribute :PRIVATE
 Eject Default . . . . . . . :KEEP
 
 Media Type:         Media1   Media2   Media3   Media4   Media5
 Scratch Threshold:     100      150      100        0        0
 Scratch Number:       1250      725     1100        0        0
Media Type:         Media6   Media7   Media8   Media9   Media10
 Scratch Threshold:     100      150      100        0        0
 Scratch Number:       1250      725     1100        0        0
Media Type:         Media11  Media12  Media13  
Scratch Threshold:       50      100      500  
Scratch Number:         250      150     1000 
 Use DOWN Command to View Next Panel;
 Use HELP Command for Help; Use END Command to Exit.

The following fields are displayed:

CDS NAME

The name of the control data set to which this library is associated.

LIBRARY NAME

The name you specified in the library definition on the Tape Library Management Application Selection panel.

LIBRARY TYPE

The type of library. Valid types are: AUTOMATED and MANUAL.

DEVICE TYPE

The device type associated with the library:

dddd-mmm (for an automated tape library including a virtual tape library), where dddd is the device type of the library, and mmm is the model. For a composite library that is part of a multi-cluster grid, the distributed libraries should be displayed for the underlying machine and model types. "GRID" might be displayed for the composite library’s device type
MANUAL (for a Manual Tape Library)
-------- the value is not available.
???????? the value cannot be displayed due to an error.

LIBRARY ID

Establishes the connection between the software-assigned library name and the tape drives that belong to the library. A valid value is entered as five-hexadecimal digits. For an ATLDS, it is defined at the library by the customer engineer and must also match what is optionally specified in the HCD LIBRARY-ID parameter. This value is returned by the control unit in response to a read device characteristics command. For an MTL, it must match what was specified in the HCD LIBRARY-ID parameter. Valid values are 00001 - FFFFF; a default value of 00000 is not allowed.

DESCRIPTION

This is a 120-byte field that the installation uses to describe the library. There are no restrictions on its content.

CONSOLE NAME

The name of the MVS console associated with the tape library being defined. The console name provides for precise routing of console messages pertaining to a specific library. When the console name is not specified, console name routing support is not provided. The console name is passed to the installation exits for their use.

ENTRY DEFAULT DATA CLASS

Specifies the data class to be used to determine the interchange attributes for private volumes entered into the tape library. No other attributes of the data class are used. You can use the cartridge entry installation exit (CBRUXENT) to assign appropriate interchange values that override the default data class specifications.

Note: The specified data class name is not automatically assigned or used as the default data class policy name for outboard policy management.

ENTRY DEFAULT USE ATTRIBUTE

The default volume use attribute for the cartridges entered into the library.

PRIVATE: These tape cartridges can be used to satisfy specific volume requests.
SCRATCH: These tape cartridges can be used to satisfy nonspecific volume requests.

EJECT DEFAULT

The default action for the TCDB volume record when a tape cartridge is ejected from the library being defined.

PURGE: The volume record is deleted from the TCDB.
KEEP: The volume record is kept in the TCDB.

Note: No matter which disposition is specified, the volume record in the ATLDS library manager inventory is deleted upon cartridge ejection.

MEDIA TYPE

The following are recognized media types:

MEDIA1: IBM Cartridge System Tape
MEDIA2: IBM Enhanced Capacity Cartridge System Tape
MEDIA3: IBM High Performance Cartridge Tape
MEDIA4: IBM Extended High Performance Cartridge Tape
MEDIA5: IBM Enterprise Tape Cartridge
MEDIA6: IBM Enterprise WORM Tape Cartridge
MEDIA7: IBM Enterprise Economy Tape Cartridge
MEDIA8: IBM Enterprise Economy WORM Tape Cartridge
MEDIA9: IBM Enterprise Extended Tape Cartridge.
MEDIA10: IBM Enterprise Extended WORM Tape Cartridge.
MEDIA11: IBM Enterprise Advanced Tape Cartridge.
MEDIA12: IBM Enterprise Advanced WORM Tape Cartridge.
MEDIA13: IBM Enterprise Advanced Economy Tape Cartridge.

SCRATCH THRESHOLD

The minimum acceptable number of scratch volumes for each media type in the library.

SCRATCH NUMBER

The number of tape cartridges available to satisfy nonspecific volume requests.

Figure 2 shows the second part of the Tape Library Display panel.

Figure 2. Tape Library Display Panel (Page 2 of 2)

   Panel  Utilities  Scroll  Help
 ------------------------------------------------------------------------------
                              TAPE LIBRARY DISPLAY                 Page 2 of 2
 Command ===>
 
 CDS Name . . . :SCDS.TEMP.PRIMARY
 Library Name . :LIB1
 Library Type . :AUTOMATED
 Device Type  . :3495-L50
 Library ID . . :0001C
 
 Number of Slots  . :16260
 Empty Slots  . . . :2050
 Initial Online Status :
   *SYSPLX01:      *SYSPLX02:      *SYSPLX03:      *SYSPLX04:
    SYSSTM01:YES    SYSSTM08:       SYSSTM15:       SYSSTM22:
    SYSSTM02:       SYSSTM09:       SYSSTM16:       SYSSTM23:
    SYSSTM03:       SYSSTM10:       SYSSTM17:       SYSSTM24:
    SYSSTM04:YES    SYSSTM11:       SYSSTM18:       SYSSTM25:
    SYSSTM05:       SYSSTM12:       SYSSTM19:       SYSSTM26:
    SYSSTM06:       SYSSTM13:       SYSSTM20:       SYSSTM27:
    SYSSTM07:       SYSSTM14:       SYSSTM21:       SYSSTM28:
 Use UP Command to View Previous Panel;
 Use HELP Command for Help; Use END Command to Exit.

The following fields are displayed:

NUMBER OF SLOTS

The number of tape cartridge slots within the tape library. This number is always zero for an MTL.

EMPTY SLOTS

The number of tape cartridge slots that are empty and available within the tape library. This number is always zero for an MTL.

INITIAL ONLINE STATUS

The status of whether this tape library should be:

Online (YES)
Offline (NO)
Not connected (blank)

to each system or system group in the SMS complex when the SCDS is activated. As the online/offline status is changed with the SMS VARY, LIBRARY command, the current status is maintained in the ACDS but not in the base SCDS. Thus, the status values in the base SCDS may not be current.

The system and system group names shown are the actual names taken from the base configuration record of the CDS. The number of system and system group names shown can vary between one and thirty-two. The display shows the difference between system names and system group names by preceding each system group name by an asterisk.