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 the following sections:
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, use the DEFINE LIBRARY command to define a SCSI library and specify the DEVICE parameter. The DEVICE parameter is required and specifies the name by which the library's robotic mechanism is known to the system. You could define a library named AUTOLIB by using the following command:
define library autolib libtype=scsi device=lb3.0.0.0
For shared libraries, see Configuring TSM Servers to Share SAN-Connected Devices.
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 output from this command:
Figure 10. Standard Query Library Report
+--------------------------------------------------------------------------------+ |Library Library Device | |Name Type | |---------- ------- --------- | |MANLIB MANUAL | |AUTOLIB SCSI MT3.0.0.0 | | | +--------------------------------------------------------------------------------+
Task | Required Privilege Class |
---|---|
Update libraries | System or unrestricted storage |
You can update a previously defined library by issuing the UPDATE LIBRARY command.
The device name is the only attribute on a SCSI library that can be updated. 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=lb4.0.0.0
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 want to delete a library named MANUALMOUNT. After deleting all of the drives defined as part of this library, issue the following command to delete the library itself:
delete library manualmount