Use this command to define a library. A library is a collection of one or more drives, and possibly robotic devices (depending on the library type), which can be used to access storage volumes.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-DEFine LIBRary--libraryname----------------------------------> .-LIBType--=--MANUAL---------------. >-----+----------------------------------+--------------------->< '-LIBType--=--+-MANUAL-----------+-' +-SCSI--| A |------+ +-349X--| B |------+ +-EXTernal--| C |--+ '-ACSLS--| D |-----' A |---DEVIce--=--device_name--------------------------------------| B .-SCRATCHCATegory--=--301-----. |---+-----------------------------+-----------------------------> '-SCRATCHCATegory--=--number--' .-PRIVATECATegory--=--300-----. >-----+-----------------------------+---DEVIce--=--device_name--| '-PRIVATECATegory--=--number--' C |---EXTERNALManager--=--path_name-------------------------------| D |---ACSID--=--number--------------------------------------------|
Parameters
When support for 3590 drives in 349X libraries is enabled (by the ENABLE3590LIBRARY option in the server options file), TSM automatically creates two scratch categories when the library is defined. The first category is for 3490 scratch volumes, and is either the value specified with this parameter, or the default 301 (X'12D'). The second scratch category is for 3590 scratch volumes, and is one greater than the value specified with the SCRATCHCATEGORY parameter. The default value for this second category is 302 (X'12E').
Attention: When you enable 3590 support for a 3494 library shared between TSM and other applications, data loss can occur if TSM creates a duplicate category for 3590 scratch volumes.
For more information on specifying a category number, see Administrator's Guide.
TSM needs the device's file name to work with removable media devices.
For the IBM 3494, the device name is the symbolic name you entered in the
configuration file for the library. For devices other than the 3494,
the special file names are shown here. In this table, x
denotes any number from 0 to 7.
Special File Name | Description |
---|---|
/dev/rmt/xmt | Used by all TSM-supported tape drives (not supported by IBM hardware device drivers) |
/dev/rmt/xlb | Used by SCSI-attached libraries that are supported by the TSM device driver |
/dev/rmt/xop | Used by all TSM-supported optical drives |
/dev/rmtxst | Used by the GENERICTAPE and 3570/3590 device types |
/dev/rmtxsmc | Used by 3570 and 3575 libraries, and used to define the Automatic Cartridge Facility feature of the IBM 3590 B11 as a library |
See the DEVICE parameter description in the DEFINE DRIVE command and the Administrator's Guide for additional information on device names.
Examples
Task 1
Define a library named MANLIB with the library type of MANUAL.
Task 2
Define a library named EZLIFE with a library type of SCSI and a device name of /dev/rmt/01b.
Task 3
Define a library named ACSLIB with a library type of ACSLS and an acsid of 1.
Related Commands
Table 63. Commands Related to DEFINE LIBRARY
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
DEFINE DRIVE | Assigns a drive to a library. |
DELETE LIBRARY | Deletes a library. |
QUERY DRIVE | Displays information about drives. |
QUERY LIBRARY | Displays information about one or more libraries. |
UPDATE DRIVE | Changes the attributes of a drive. |
UPDATE LIBRARY | Changes the attributes of a library. |