Administrator's Guide


Defining and Managing Libraries

As an administrator, you manage all TSM libraries. Once you determine the type of library you require, you must define that library to TSM. For information on TSM library types, see MANUAL Libraries, SCSI Libraries, 349X Libraries, ACSLS Libraries, and External Libraries.

Defining Libraries


Task Required Privilege Class
Define libraries System or unrestricted storage

Before you can use a drive, you must first define the library to which the drive belongs. This is true for both manually mounted drives and drives in automated libraries.

To define a new library, use the DEFINE LIBRARY command. For example, suppose you have several stand-alone tape drives that will need to be mounted manually by an operator. You could define a library named MANUALMOUNT for these drives by using the following command:

define library manualmount libtype=manual

For automated libraries, you use the DEFINE LIBRARY command to define a SCSI or 349X library and specify the DEVICE parameter. The DEVICE parameter is required and specifies the special file created by the device driver, by which the library's robotic mechanism is known.

This example can apply to any SCSI library. This assumes that you have configured the robot device driver, as described in Installing Device Drivers, and determined the appropriate device name string as shown in the example. If you have an Exabyte EXB-120 device, you may define a library named ROBOTMOUNT using the following command:

define library robotmount libtype=scsi device=/dev/rmt/0lb

If you have an IBM 3590 B11 device with device special file name /dev/rmt/0smc, you can define a library named MAINMOUNT using the following command:

define library mainmount libtype=scsi device=/dev/rmt/0smc

Suppose you have an IBM 3494 Tape Library Dataserver connected to your system, and that you have defined the symbolic name 3494a for the library in the /etc/ibmatl.conf file. You can define a library named AUTOMOUNT using the following command:

define library automount libtype=349x device=3494a

ACSLS Support

TSM supports tape libraries controlled by StorageTek Automated Cartridge System Library Software (ACSLS). The ACSLS architecture is a client/server model. The ACSLS library server manages the physical aspects of tape cartridge storage and retrieval. The ACSLS client application communicates with the library server to access tape cartridges in an automated library. TSM is one of the client applications that gains access to tape cartridges by interacting with ACSLS through its client, which is known as the control path. TSM reads and writes data on tape cartridges by interacting directly with tape drives through the data path. The control path and the data path are two different paths. The ACSLS client daemon must be initalized prior to starting the TSM server. See /usr/adsm.devices/bin/rc.acs_ssi for the client daemon invocation. For detailed installation, configuration, and system administration of ACSLS, refer to the StorageTek related documentation.

Requesting Information about Libraries


Task Required Privilege Class
Request information about libraries Any administrator

You can request information about any or all libraries by using the QUERY LIBRARY command. Either a standard or a detailed report can be requested.

For example, to display information about your libraries, issue the following command:

query library

The following shows an example of the output from this command.

+--------------------------------------------------------------------------------+
|                                                                                |
|Library    Library    Device         Private     Scratch     External           |
|Name       Type                      Category    Category    Manager            |
|-------    -------    --------       --------    --------    --------           |
|MANLIB     MANUAL                                                               |
|EXB        SCSI       /dev/rmt/2lb                                              |
|                                                                                |
+--------------------------------------------------------------------------------+

Updating Libraries


Task Required Privilege Class
Update libraries System or unrestricted storage

You can update a previously defined library by issuing the UPDATE LIBRARY command.

Automated Libraries (SCSI)

The only attribute on a SCSI library that can be updated is the device name. This may be necessary if your system or device is reconfigured, causing the device name to change. For example, you have defined a SCSI library named AUTOLIB, but the device is reconfigured and its name is changed. You can then issue the following command to inform the TSM server of the change:

update library autolib device=/dev/rmt/1lb
Note:MANUAL libraries, which have no DEVICE attribute, cannot be updated.

Deleting Libraries


Task Required Privilege Class
Delete libraries System or unrestricted storage

Before deleting a library with the DELETE LIBRARY command, all of the drives that have been defined as part of the library must be deleted. See Deleting Drives.

For example, suppose you wish to delete a library named MANUALMOUNT. After deleting all of the drives defined as part of this library, you could issue the following command to delete the library itself:

delete library manualmount


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]