Administrator's Reference

DEFINE DRIVE (Define a Drive to a Library)

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--------------------------->
 
>-----DEVIce--=--device_name----+---------------------------+--->
                                |                     (1)   |
                                '-ELEMent--=--address-------'
 
      .-CLEANFREQuency--=--NONE---------.
>-----+---------------------------------+----------------------><
      '-CLEANFREQuency--=--+-NONE-----+-'
                           +-ASNEEDED-+
                           '-value----'
 

Notes:

  1. The ELEMENT parameter is required for drives in SCSI 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 (that is, the special file name) that corresponds to the drive. For example, you might specify /dev/rmt/c0t3d0BEST.

After you configure the device drivers for the tape drives that are supported by the standard HP-UX device drivers, the operating system automatically assigns the special file names during system start-up. A single drive can have multiple special file names, depending on the format and recording density that the drive supports.

Select the device name to use to define the drive to TSM. Choose the format and density that you want TSM to use. For example, one device may have all of the following special file names:

The different names represent different recording formats, densities, and operating characteristics such as data compression. You might choose the name /dev/rmt/c1t0d0BEST to have TSM use the best recording format and density available on the drive. To see these file names, you can use the HP-UX System Administration Manager (SAM), or use the IOSCAN command. For example, to see the device special files available for tape drives, enter the command:

 > /usr/sbin/ioscan -fkn -C tape

The LSSF command can help you get more information about a specific device special file name. See the documentation for your operating system for details about special file names.

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.

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 already defined a manual tape library named MANLIB by using the DEFINE LIBRARY command. 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/rmt/0m

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 manual cddrive device=/cdrom

Related Commands

Table 52. 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 ]