Tivoli Storage Manager for Windows: 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-'  '-ONLine--=--+-Yes-+-'
                                            '-No--'
 
>--+--------------------------+--------------------------------->
   |                     (1)  |
   '-ELEMent--=--address------'
 
>--+----------------------------+------------------------------->
   |                       (2)  |
   '-ACSDRVID--=--drive_id------'
 
>--+---------------------------------+-------------------------><
   '-CLEANFREQuency--=--+-NONE-----+-'
                        +-ASNEEDED-+
                        '-value----'
 
 

Notes:

  1. The ELEMENT parameter is valid only for drives in SCSI libraries when the command is issued from a server that is a library manager.

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

|Specify DEVICE="" on the UPDATE DRIVE command to remove any existing |device specification. The server will not be able to access the |drive. However, a NAS file server can access the drive if a path to the |drive is defined with the DEFINE PATH command.

For additional information about device names, see the DEVICE parameter description of the DEFINE DRIVE command.

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 make 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 DEVICE |or ELEMENT parameters 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 mountpoint will fail, rather than queue up for a mountpoint.

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 a drive in a SCSI library. When the library is shared, this parameter is valid only when the command is by a library manager. This parameter is optional when the SCSI library contains only one drive and required when the SCSI library contains more than one drive.

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

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 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. You can 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 filer. If a drive is attached only to a NAS file server (not to a |storage agent or server), do not specify ASNEEDED. |

value
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 value |for the cleaning frequency to ensure that the drives receive adequate |cleaning. Consult the drive manufacturer's information for |cleaning recommendations. |

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 319. 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.
DEFINE PATH Defines a path from a source to a destination.
DELETE DRIVE Deletes a drive from a library.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.
UPDATE PATH Changes the path from a source to a destination.


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