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:
Do the following to set the total slots higher than the scratch threshold:IDC31903I NUMBERSCRATCHVOLUMES IS GREATER THAN AVAILABLE VOLUMES
followed immediately by:ALTER libname LIBENTRY NUMBERSLOTS(num+1)
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