Tivoli Header
Administrator's Reference
Use this command to update a drive.
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DRive--library_name--drive_name----------------------->
>--+--------------------+--+--------------------------+--------->
'-ONLine--=--+-Yes-+-' | (1) |
'-No--' '-ELEMent--=--address------'
>--+----------------------------+------------------------------->
| (2) |
'-ACSDRVID--=--drive_id------'
.-CLEANFREQuency--=--NONE----------.
>--+----------------------------------+------------------------><
'-CLEANFREQuency--=--+-NONE------+-'
+-ASNEEDED--+
'-gigabytes-'
Notes:
- The ELEMENT parameter is valid only for drives in SCSI libraries when the
command is issued from a server that is a library manager.
- The ACSDRVID parameter is valid only for drives in ACSLS libraries.
Parameters
- library_name (Required)
- Specifies the name of the library to which the drive is assigned.
- drive_name (Required)
- Specifies the name that is assigned to the drive.
- ONLine
- Specifies whether the drive is available for use. This parameter
allows drives to be taken offline and used for another activity, such as
maintenance. This parameter is optional.
You can issue this command when the drive is involved in an active process
or session, but it is not recommended. If you take the drive offline
while it is in use, the drive will be marked offline. However, the
mounted volume will complete its current process. If this volume was
part of a series of volumes for a given transaction, the drive will not be
available to complete mounting the series. If no other drives are
available, the process fails.
Attention: When a drive is in use, do not specify the ELEMENT
parameter with the ONLINE parameter. The drive will not be updated, and
the command will fail.
The drive state is not changed even if the server is halted and
restarted. If a drive is offline when the server is restarted, a
warning message is issued stating that the drive must be manually brought
online. If all the drives in a library have been updated to be offline,
processes that need a library mount point will fail, rather than queue up for
a mount point.
- YES
- Specifies that the drive is available for use (online).
- No
- Specifies that the drive is not available for use (offline).
- 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 library manager server.
- ACSDRVID
- Specifies the ID of the drive 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. The
server needs the drive ID to connect the physical location of the drive to the
drive's SCSI address. See your STK documentation for
details.
- CLEANFREQuency
- Specifies how often the server activates drive cleaning. This
parameter is optional. 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.
Use this parameter 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 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
Task
Update DRIVE3, located in the library named AUTO, by changing the element
address to 119.
- Command:
- update drive auto drive3 element=119
Task
Update DRIVE3, located in the library MANLIB, to take it offline.
- Command:
- update drive manlib drive8 online=no
Related Commands
Table 318. Commands Related to UPDATE DRIVE
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]