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

Notes:

  1. The ELEMENT 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.

drive_name (Required)
Specifies the name that is assigned to the drive.

DEVIce
Specifies the name of the device (that is, the special filename) that corresponds to the drive. For example, you might specify /dev/rmt/c0t3d0BEST. This parameter is optional. See the DEVICE parameter description of the DEFINE DRIVE command for special device names.

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.

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 282. 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 ]