Administrator's Reference

UPDATE DRIVE (Update a Drive)

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-----.
>-----+-------------------------+---+--------------------+------>
      '-DEVIce--=--device_name--'   '-ONLine--=--+-Yes-+-'
                                                 '-No--'
 
>-----+---------------------------+----------------------------->
      |                     (1)   |
      '-ELEMent--=--address-------'
 
>-----+-----------------------------+--------------------------->
      |                       (2)   |
      '-ACSDRVID--=--drive_id-------'
 
      .-CLEANFREQuency--=--NONE---------.
>-----+---------------------------------+----------------------><
      '-CLEANFREQuency--=--+-NONE-----+-'
                           +-ASNEEDED-+
                           '-value----'
 

Notes:

  1. The ELEMENT parameter is valid only for drives in SCSI libraries.

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

DEVIce
Specifies the name of the device that corresponds to the drive. For example, you might specify mt3. This parameter is optional. For additional information about device names, see the DEVICE parameter description of the DEFINE DRIVE command and the Administrator's Guide.

ONLine
Specifies whether the drive is available for use. This parameter is optional.

YES
Specifies that the drive is available for use (online).

No
Specifies that the drive is not available for use (offline).
Note:You can make a drive offline even when the drive is in use, but this is not recommended. The currently mounted volume will complete its process and the drive will become offline following the dismount. If this volume was part of a series of volumes for a given transaction, the drive will no longer be available to complete mounting the series. If no other drives are available, this transaction may fail.

ELEMent
Specifies the new value to be used for the drive's element address within a SCSI library. This parameter is optional and is only valid for a drive located in a SCSI library. To find the element address for your library configuration, access the TSM Web site at: http://www.tivoli.com/tsm . At this URL, click on Product Details, click on Supported Device Lists, click on your product, and then the appropriate device.

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. TSM 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 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 TSM-controlled drive cleaning only for SCSI libraries that do not have automatic cleaning support in their device hardware.

NONE
Specifies that TSM does not track cleaning for this drive. Use this parameter 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 will 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

Update the drive named DRIVE3 located in the library named AUTO by changing the element address to 119.

Command:
update drive auto drive3 element=119

Related Commands

Table 293. Commands Related to UPDATE DRIVE

Command Description
CHECKIN LIBVOLUME Checks a storage volume into an automated library.
CHECKOUT LIBVOLUME Checks a storage volume out of an automated library.
CLEAN DRIVE Marks a drive for cleaning.
DEFINE DRIVE Assigns a drive to a library.
DELETE DRIVE Deletes a drive from a library.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.


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