Tivoli Header
Administrator's Reference
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:
- Before you issue the DEFINE DRIVE command for a removable media device like a
Jaz, Zip, or CD-ROM drive, you must load the drive with properly formatted and
labeled media. See the chapters on adding devices and managing media in
the Administrator's Guide for more information.
- 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----------------------->
>--+-------------------------+--+--------------------------+---->
'-WWN--=--world_wide_name-' '-SERial--=--serial_number-'
.-ONLine--=--Yes-----.
>--+--------------------+--+--------------------------+--------->
'-ONLine--=--+-Yes-+-' | (1) |
'-No--' '-ELEMent--=--address------'
>--+----------------------------+------------------------------->
| (2) |
'-ACSDRVID--=--drive_id------'
(3)
.-CLEANFREQuency--=--NONE----------.
>--+----------------------------------+------------------------><
'-CLEANFREQuency--=--+-NONE------+-'
+-ASNEEDED--+
'-gigabytes-'
Notes:
- 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.
- ACSDRVID is required for drives in ACSLS libraries. This parameter
is not valid for non-ACSLS libraries.
- 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.
- WWN
- Specifies the Fibre Channel world wide name for the drive. This
parameter is valid only for drives in SCSI libraries. This parameter is
required if the device will be accessed by a data mover for server-free data
movement.
- SERial
- Specifies the serial number for the drive being defined. This
parameter is required if the device will be accessed by a data mover for
server-free data movement.
- 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:
- This parameter is valid for a drive in a SCSI library when the command is
issued from a Tivoli Storage Manager server.
- This parameter is optional in a SCSI library, including a shared SCSI
library, that only contains one drive.
- 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:
- Use the bytes-per-second rating for the drive to determine a
gigabytes-per-hour value.
- Multiply the gigabytes-per-hour value by the recommended hours of use
between cleanings.
- 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=mt3.0.0.0
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=mt3.0.0.0
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=mt3.0.0.0
Task
Define a drive, SRVDRIVE01, that will be used with a server-free data mover
device. The drive is defined to library SCSI1. The drive has a
world wide name of 163874847023749e, and a serial number of
13-56789. The device name of the drive is
mt3.0.0.0.
- Command:
-
define drive scsi1 srvdrive01 wwn=163874847023749e serial=13-56789
define path scsidm1 srvdrive01 srctype=datamover desttype=drive
library=scsi1 device=mt3.0.0.0
Related Commands
Table 66. Commands Related to DEFINE DRIVE
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]