Use this command to define a drive. Each drive is assigned to a single library. The library must be defined before you issue this command. You can define more than one drive for a given library by issuing the DEFINE DRIVE command once for each drive. Stand-alone drives always require a manual library. For additional information, see Administrator's Guide.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-DEFine DRive--library_name--drive_name-----------------------> .-ONLine--=--Yes-----. >--+----------------------------+--+--------------------+-------> '-DEVIce--=--+-device_name-+-' '-ONLine--=--+-Yes-+-' '-FILE--------' '-No--' >--+--------------------------+---------------------------------> | (1) | '-ELEMent--=--address------' >--+----------------------------+-------------------------------> | (2) | '-ACSDRVID--=--drive_id------' (3) .-CLEANFREQuency--=--NONE---------. >--+---------------------------------+------------------------->< '-CLEANFREQuency--=--+-NONE-----+-' +-ASNEEDED-+ '-value----'
Notes:
Parameters
For a drive that is device type REMOVABLEFILE, specify its drive letter and a colon, for example, E:.
For a drive in a FILE library, use the keyword FILE. FILE drives are created automatically in a FILE library when the DEFINE DEVCLASS command is issued with DEVTYPE=FILE and SHARED=YES. Shared file libraries should be associated with a single device class.
For devices that are supported by either the ADSMSCSI driver or Windows drivers, use an alias name to refer to the devices. The alias name replaces the real ADSMSCSI name or Windows name for a device.
An alias name has the form mtx.y.z.n or lbx.y.z.n. The mt indicates that the device is a tape device, and the lb indicates that the device is the controller for a tape autochanger or an automated library. The alias can be abbreviated. Some examples follow:
Because the alias name does not change unless you change how the device is physically attached, always use the alias name for devices that are controlled by Windows device drivers. To distinguish between a real device name and an alias, the server checks for a backslash (\) at the beginning of the name. If the name begins with a backslash, the server recognizes that the name is the real device name and not an alias.
Notes:
The server needs the element address to connect the physical location of the drive to the drive's SCSI address. To find the element address for your library configuration, consult the manufacturer's information.
Additional information on element addresses can be found at the TSM Web site: http://www.tivoli.com/support/storage_mgr/tivolimain.html. Follow the links to device information. Select the appropriate product and platform, then scroll to the required device. Click on a specific device to see element addresses.
Consult the drive manufacturer's information for cleaning recommendations. If the information gives recommendations for cleaning frequency in terms of hours of use, convert to a gigabytes value by doing the following:
Examples
Task
Specify the name TAPEDRIVE0 for a tape drive in the library, MANLIB. Specify the device name as mt3.0.0.0.
define drive manlib tapedrive0 device=mt3.0.0.0
Task
You have already defined a manual library named MANUAL using the DEFINE LIBRARY command. You now want to inform the server that you have a stand-alone Iomega Zip drive that is accessed as drive letter H and is ready for use. You choose the name ZIP1 for this drive.
define drive manual zip1 device=h:
Task
Define a drive in an autochanger defined as library AUTOLIB1. The drive is element number 82.
define drive autolib1 tapedrive0 device=mt3.0.0.0 element=82
Task
Define a drive in an ACSLS library with a library name of ACSLIB and a drive name of ACSDRV1.
define drive acslib acsdrv1 device=mt3.0.0.0 acsdrvid=1,2,3,4
Task
Define a drive for a device type of REMOVABLEFILE (CDROM).
define drive manual cddrive device=e:
Task
Define a drive, TAPE0, to a LTO library named 3584LIB. The drive is located at element 104.
define drive 3584lib tape0 device=\\.\Tape0 element=104
Task
Define a FILE drive in an existing FILE library named SANLIB.
define drive sanlib san1 device=file
Related Commands
Table 65. Commands Related to DEFINE DRIVE
Command | Description |
---|---|
DEFINE DRIVEMAPPING | Defines the drive name that will be mapped to the storage agent allowing for direct storage and retrieval of data. |
DEFINE LIBRARY | Defines an automated or manual library. |
DEFINE PATH | Defines a path from a source to a destination. |
DELETE DRIVE | Deletes a drive from 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. |