Tivoli Header

Administrator's Reference

DEFINE DRIVE (Define a Drive to a Library)

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.

Note:
Beginning with Version 5.1, the DEFINE PATH command, instead of the DEFINE DRIVE command, is used to specify the device names of each of the drives in the libraries. For more information on paths, see the 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-----.
>--+--------------------+--+--------------------------+--------->
   '-ONLine--=--+-Yes-+-'  |                     (1)  |
                '-No--'    '-ELEMent--=--address------'
 
>--+----------------------------+------------------------------->
   |                       (2)  |
   '-ACSDRVID--=--drive_id------'
 
                               (3)
   .-CLEANFREQuency--=--NONE----------.
>--+----------------------------------+------------------------><
   '-CLEANFREQuency--=--+-NONE------+-'
                        +-ASNEEDED--+
                        '-gigabytes-'
 
 

Notes:

  1. The ELEMENT parameter is valid only for drives in SCSI libraries. This parameter is not effective when the command is issued from a library client server (that is, when the library type is SHARED). This parameter is required for a drive in a SCSI library containing more than 1 drive.

  2. ACSDRVID is required for drives in ACSLS libraries. This parameter is not valid for non-ACSLS libraries.

  3. The CLEANFREQUENCY parameter is valid only for drives in SCSI libraries.

Parameters

library_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.

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
Specifies the element address of the drive within a SCSI library. The server uses the element address to connect the physical location of the drive to SCSI address of the drive. To find the element address for your library configuration, consult the manufacturer's information.

Additional information on element addresses can be found at the Tivoli Storage Manager 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.

Notes:

  1. This parameter is valid for a drive in a SCSI library when the command is issued from a Tivoli Storage Manager server.

  2. This parameter is optional in a SCSI library, including a shared SCSI library, that only contains one drive.

  3. This parameter is required in a SCSI library, including a shared SCSI library, that contains more than one drive.

ACSDRVID
Specifies the ID of the drive that is being accessed in an ACSLS library. 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. The server 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 server activates drive cleaning. This parameter is optional. The default is NONE. For the most complete automation of cleaning for an automated library, you must have a cleaner cartridge checked into the library's volume inventory. For details on using this parameter for automated and manual libraries, see Administrator's Guide.
Note:
There are special considerations if you plan to use server-activated drive cleaning with a SCSI library that provides automatic drive cleaning support in its device hardware. See the Administrator's Guide for details.

NONE
Specifies that the server does not track cleaning for this drive. This value can be used for libraries that have their own automatic cleaning.

ASNEEDED
Specifies that the server loads the drive with a checked-in cleaner cartridge only when a drive reports to the device driver that it needs cleaning.
Note:
Tivoli Storage Manager does not control the drives connected to the NAS file server. If a drive is attached only to a NAS file server (no connection to a storage agent or server), do not specify ASNEEDED for the cleaning frequency.

gigabytes
Specifies, in gigabytes, how much data is processed on the drive before the server loads the drive with a cleaner cartridge. The server resets the gigabytes-processed counter each time it loads a cleaner cartridge in the drive.

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:

  1. Use the bytes-per-second rating for the drive to determine a gigabytes-per-hour value.
  2. Multiply the gigabytes-per-hour value by the recommended hours of use between cleanings.
  3. Use the result as the cleaning frequency value.
Note:
For IBM 3590 and IBM 3570, we recommend that you specify a gigabyte value for the cleaning frequency to ensure that the drives receive adequate cleaning. Consult the drive manufacturer's information for cleaning recommendations. Using the cleaning frequency recommend by IBM will not overclean the drives.

Examples

Note:
The following DEFINE DRIVE definitions are followed by their corresponding DEFINE PATH definitions. The device parameter is no longer used in the DEFINE DRIVE definition, but is now included in the DEFINE PATH definition.

Task

Define a drive in a manual library with a library name of LIB01 and a drive name of DRIVE01.

Command:
define drive lib01 drive01
define path server01 drive01 srctype=server desttype=drive 
library=lib01 device=/dev/rmt0

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 acsdrvid=1,2,3,4
define path server01 acsdrv1 srctype=server desttype=drive 
library=acslib device=/dev/rmt0

Task

Define a drive in an automated library with a library name of AUTO8MMLIB and a drive name of DRIVE01.

Command:
define drive auto8mmlib drive01 element=82
define path server01 drive01 srctype=server desttype=drive 
library=auto8mmlib device=/dev/rmt0

Related Commands

Table 66. Commands Related to DEFINE DRIVE

Command Description
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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]