Administrator's Guide


Defining and Managing Libraries

As an administrator, you manage all ADSM libraries. Once you determine the type of library you require, you must define that library to ADSM. For information on ADSM library types, see "MANUAL Libraries", "SCSI Libraries", "349X 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/lb0

Suppose you have an IBM 3494 Tape Library Dataserver connected to your system, and that you have defined one LMCP whose device name is /dev/lmcp0 . You can define a library named AUTOMOUNT using the following command:

define library automount libtype=349x device=/dev/lmcp0

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/lb2                                                  |
|                                                                                |
+--------------------------------------------------------------------------------+

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 ADSM server of the change:

update library autolib device=/dev/lb1
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 ]