Administrator's Reference
Use this command to define a drive that TSM can use to access data on
storage volumes. Each drive is assigned to a single library. You
must define this library 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-type
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--lib_name--drive_name--------------------------->
.-ONLine--=--Yes-----.
>-----DEVIce--=--device_name----+--------------------+---------->
'-ONLine--=--+-Yes-+-'
'-No--'
>-----+---------------------------+----------------------------->
| (1) |
'-ELEMent--=--address-------'
>-----+-----------------------------+--------------------------->
| (2) |
'-ACSDRVID--=--drive_id-------'
.-CLEANFREQuency--=--NONE---------.
>-----+---------------------------------+----------------------><
'-CLEANFREQuency--=--+-NONE-----+-'
+-ASNEEDED-+
'-value----'
Notes:
- The ELEMENT parameter is required for drives in SCSI libraries.
- ACSDRVID is required for drives in ACSLS libraries. This parameter
is not valid for non-ACSLS libraries.
Parameters
- lib_name (Required)
- Specifies the name of the library to which the drive is assigned.
This parameter is required for all drives, including stand-alone
drives. The specified library must have been previously defined by
using the DEFINE LIBRARY command.
- drive_name (Required)
- Specifies the name that is assigned to the drive. The maximum
length of this name is 30 characters.
- DEVIce (Required)
- Specifies the name of the device (the special file name) that corresponds
to the drive. For example, you might specify /dev/mt2 or
/dev/rop2.
To access a drive that is device type REMOVABLEFILE, use a mount point such
as, /cdrom.
See the device special file names in the following table. In this
table, x denotes any number from 1 to 9.
Special File Name
| Description
|
/dev/mtx
| Used by all TSM-supported tape drives (not supported by IBM hardware
device drivers)
|
/dev/lbx
| Used by most TSM-supported SCSI libraries
|
/dev/ropx
| Used by all TSM-supported optical drives
|
/dev/rmtx
| Used by the GENERICTAPE and 3570/3590 device types
|
/dev/smcx
| Used by 3570 and 3575 libraries, and used to define the Automatic
Cartridge Facility feature of the IBM 3590 B11 as a library
|
/dev/lmcpx
| Used by 349X automatic tape libraries
|
/dev/cdx
| Used by REMOVABLEFILE device type (CDROM)
|
- ONLine
- Specifies whether the drive is available for use. This parameter is
optional. The default is YES.
- Yes
- Specifies that the drive is available for use.
- No
- Specifies that the drive is not available for use.
- ELEMent=address
- Specifies the new value to be used for the drive's element address
within a SCSI library. This parameter is optional. TSM 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, access the TSM Web site at:
http://www.tivoli.com/tsm
. At this URL, follow the links to device information. You will
need to click on your product and platform and then scroll to the required
device. When you click on your selected device, you will get the
element address.
- ACSDRVID
- Specifies the ID of the drive that is being accessed. The drive ID
is a set of numbers that indicates the physical location of a drive within an
ACSLS library. This drive ID must be specified as a,l,p,d,
where a is the acsid, l is the LSM (library storage
module), p is the panel number, and d is the drive
ID. TSM needs the drive ID to connect the physical location of the
drive to the drive's SCSI address. See the STK documentation for
details.
- CLEANFREQuency
- Specifies how often the TSM activates drive cleaning. You must have
a cleaner cartridge checked into the library's volume inventory to use
this parameter. This parameter is optional. The default is
NONE.
Note: | Use drive cleaning that is controlled by TSM only for SCSI libraries that do
not have automatic drive cleaning support in their device hardware.
|
- NONE
- Specifies that TSM does not track cleaning for this drive. Use this
for libraries that have their own automatic cleaning.
- ASNEEDED
- Specifies that TSM loads the drive with a checked-in cleaner cartridge
only when a drive reports to the device driver that it needs cleaning.
- value
- Specifies (in gigabytes) how much data to process on the drive before TSM
loads the drive with a cleaner cartridge. TSM resets the
gigabytes-processed counter each time it loads a cleaner cartridge in the
drive.
Examples
Task
You have defined a manual tape library that is named MANLIB. You now
want to inform the server that you have a tape drive that can be used to
access storage media. You choose the name TAPEDRIVE3 for this
drive.
- Command:
- define drive manlib tapedrive3 device=/dev/mt0
Task
Define a drive in an ACSLS library with a library name of ACSLIB and a
drive name of ACSDRV1 .
- Command:
- define drive acslib acsdrv1 device=/dev/mt0
acsdrvid=1,2,3,4
Task
Define a drive for a device type of REMOVABLEFILE (CDROM).
Note: | This command uses a UNIX mount point as the device. Refer to the
Administrator's Guide for more information.
|
- Command:
- define drive manlib cdrom device=/cdrom
Related Commands
Table 60. Commands Related to DEFINE DRIVE
Command
| Description
|
DEFINE LIBRARY
| Defines an automated or manual library.
|
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.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]