Optional Parameters

CONSOLENAME(consolename)

Identifies the name of the console that will receive tape library related messages.

consolename: Specifies a 2-to-8 character console name starting with an alphabetic character.

Abbreviation: CONSOLE

DESCRIPTION(desc)

Is a description for the tape library entry being altered.

desc: Lets you include a 1-to-120 character tape library description. If the description contains commas, semicolons, embedded blanks, parentheses, or slashes, the entire description must be enclosed in single quotation marks. The default for this parameter is blanks.

Abbreviation: DESC

LIBDEVTYPE(devtype)

Identifies the tape library device type.

devtype: Is an 8-character hardware device type. If you do not use this, LIBDEVTYPE is not established.

Abbreviation: LDEVT

LIBRARYID(libid)

Establishes the connection between the software-assigned tape library name and the actual tape library hardware.

libid: Is a 5-digit hexadecimal tape library serial number.

Abbreviation: LIBID

LOGICALTYPE{AUTOMATED|MANUAL}

Identifies the type of tape library being created. If you do not use this parameter, LOGICALTYPE is not established.

AUTOMATED: Indicates an automated tape library.
MANUAL: Is a manual tape library.

Abbreviation: LOGTYP

NULLIFY([LIBDEVTYPE][LOGICALTYPE])

Identifies the fields to be nullified. You can enter one or both; they are not mutually exclusive.

LIBDEVTYPE: specifies that this parameter be set to blanks, indicating that the parameter is not established.
Abbreviation: LDEVT
LOGICALTYPE: Specifies that the value of this parameter be set to blanks, which implies that this parameter is not established.
Abbreviation: LOGTYP

NUMBEREMPTYSLOTS(numslots)

Identifies the total number of empty slots in the given tape library. You can use it only when LOGICALTYPE is AUTOMATED.

numslots: Is the number of tape cartridges you can add to the tape library. Use a number from 0 to 9999999. The default is 0.

Abbreviation: NUMESLT

NUMBERSCRATCHVOLUMES(MEDIA1(num) MEDIA2(num) MEDIA3(num) MEDIA4(num) MEDIA5(num) MEDIA6(num) MEDIA7(num) MEDIA8(num) MEDIA9(num) MEDIA10(num) MEDIA11(num) MEDIA12(num) MEDIA13(num))

Identifies the total number of MEDIA1, MEDIA2, MEDIA3, MEDIA4, MEDIA5, MEDIA6, MEDIA7, MEDIA8, MEDIA9, MEDIA10, MEDIA11, MEDIA12, and MEDIA13 scratch volumes currently available in the given tape library.

MEDIA1(num): Is the number of Cartridge System Tape scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA2(num): Specifies the number of Enhanced Capacity Cartridge System Tape scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA3(num): Is the number of High Performance Cartridge Tape scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA4(num): Specifies the number of IBM Extended High Performance Cartridge Tape scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA5(num): Specifies the number of IBM® TotalStorage Enterprise Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA6(num): Specifies the number of IBM TotalStorage Enterprise WORM Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA7(num): Specifies the number of IBM TotalStorage Enterprise Economy Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA8(num): Specifies the number of IBM TotalStorage Enterprise Economy WORM Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA9(num): Specifies the number of IBM TotalStorage Enterprise Economy Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA10(num): Specifies the number of IBM TotalStorage Enterprise Economy WORM Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA11(num): Specifies the number of IBM TotalStorage Enterprise Advanced Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA12(num): Specifies the number of IBM TotalStorage Enterprise Advanced WORM Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.
MEDIA13(num): Specifies the number of IBM TotalStorage Enterprise Advanced Economy Tape Cartridge scratch volumes available. Use a number from 0 to 999999. The default is 0.

Abbreviation: NUMSCRV

NUMBERSLOTS(numslots)

Is the total number of slots in the given tape library. You can use this parameter only when LOGICALTYPE is AUTOMATED.

numslots: Is the total number of tape cartridges that can be contained in the tape library. Use a number from 0 to 9999999. The default is 0.

Abbreviation: NUMSLT

SCRATCHTHRESHOLD(MEDIA1(num) MEDIA2(num) MEDIA3(num) MEDIA4(num) MEDIA5(num) MEDIA6(num) MEDIA7(num) MEDIA8(num))]) MEDIA9(num) MEDIA10(num) MEDIA11(num) MEDIA12(num) MEDIA13(num))

Specifies the scratch volume message threshold. When the number of scratch volumes in the tape library falls below the scratch threshold, an operator action message, requesting that scratch volumes be entered into the tape library, is issued to the library's console. When the number of scratch volumes exceeds twice the scratch threshold, the message is removed from the console.

We recommend the use of ISMF panels to make library definition changes, but if you use IDCAMS, make sure that the total slots number defined is greater than the highest scratch threshold you'll need. If you issue a ALTER libname LIBENTRY SCRATCHTHRESHOLD(MEDIAx(num)) command and receive the following system message IDC31903I in response, the total slots defined are not high enough:

IDC31903I NUMBERSCRATCHVOLUMES IS GREATER THAN AVAILABLE VOLUMES

Do the following to set the total slots higher than the scratch threshold:

ALTER libname LIBENTRY NUMBERSLOTS(num+1)

followed immediately by:

ALTER libname LIBENTRY SCRATCHTHRESHOLD(MEDIAx(num))

MEDIA1(num): Specifies the threshold number of Cartridge System Tape scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA2(num): Is the threshold number of Enhanced Capacity System Tape scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA3(num): Specifies the threshold number of High Performance Cartridge Tape scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA4(num): Is the threshold number of IBM Extended High Performance Cartridge Tape scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA5(num): The threshold number of IBM TotalStorage Enterprise Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA6(num): Specifies the threshold number of IBM TotalStorage Enterprise WORM Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA7(num): Specifies the threshold number of IBM TotalStorage Enterprise Economy Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA8(num): Specifies the threshold number of IBM TotalStorage Enterprise Economy WORM Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA9(num): Specifies the threshold number of IBM TotalStorage Enterprise Economy Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA10(num): Specifies the threshold number of IBM TotalStorage Enterprise Economy WORM Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA11(num): Specifies the threshold number of IBM TotalStorage Enterprise Advanced Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA12(num): Specifies the threshold number of IBM TotalStorage Enterprise Advanced WORM Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.
MEDIA13(num): Specifies the threshold number of IBM TotalStorage Enterprise Advanced Economy Tape Cartridge scratch volumes. Use a number from 0 to 999999. The default is 0.

Abbreviation: SCRTHR