IBM Tivoli Storage Manager, Version 7.1

UPDATE DEVCLASS (Update a DLT device class)

Use the DLT device class when you are using DLT tape devices.

Privilege class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax


>>-UPDate DEVclass--device_class_name--------------------------->

>--+--------------------------+--+-------------------------+---->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE----+-'   
                                              +-DLT1-----+     
                                              +-DLT1C----+     
                                              +-DLT10----+     
                                              +-DLT10C---+     
                                              +-DLT15----+     
                                              +-DLT15C---+     
                                              +-DLT20----+     
                                              +-DLT20C---+     
                                              +-DLT35----+     
                                              +-DLT35C---+     
                                              +-DLT40----+     
                                              +-DLT40C---+     
                                              +-DLT2-----+     
                                              +-DLT2C----+     
                                              +-DLT4-----+     
                                              +-DLT4C----+     
                                              +-SDLT-----+     
                                              +-SDLTC----+     
                                              +-SDLT320--+     
                                              +-SDLT320C-+     
                                              +-SDLT600--+     
                                              +-SDLT600C-+     
                                              +-DLTS4----+     
                                              '-DLTS4C---'     

>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'   

>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'   
                '-tape_volume_prefix-'     

>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'   

>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'   
                    +-number-+     
                    '-0------'

Parameters

device_class_name (Required)

Specifies the name of the device class to be updated.

LIBRary

Specifies the name of the defined library object that contains the DLT tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

FORMAT

Specifies the recording format to be used when data is written to sequential access media. This parameter is optional.

The following table lists the recording formats and estimated capacities for DLT devices:

Table 1. Recording format and default estimated capacity for DLT
Format	Estimated Capacity	Description
DRIVE	–	The server selects the highest format that is supported by the drive on which a volume is mounted. Attention: Avoid specifying DRIVE when a mixture of drives is used within the same library. For example, do not use this option for a library that contains some drives that support recording formats superior to other drives.
DLT1	40.0 GB	Uncompressed format, using only CompacTape III or CompacTape IV cartridges
DLT1C	See note 1. 80.0 GB	Compressed format, using only CompacTape III and CompacTape IV cartridges
DLT10	10.0 GB	Uncompressed format, using only CompacTape III or CompacTape IV cartridges
DLT10C	See note 1. 20.0 GB	Compressed format, using only CompacTape III and CompacTape IV cartridges
DLT15	15.0 GB	Uncompressed format, using only CompacTape IIIxt or CompacTape IV cartridges (not CompacTape III) Note: Valid with DLT2000XT, DLT4000, and DLT7000 drives
DLT15C	See note 1. 30.0 GB	Compressed format, using only CompacTape IIIxt or CompacTape IV cartridges (not CompacTape III) Valid with DLT2000XT, DLT4000, and DLT7000 drives
DLT20	20.0 GB	Uncompressed format, using only CompacTape IV cartridges Valid with DLT4000, DLT7000, and DLT8000 drives
DLT20C	See note 1. 40.0 GB	Compressed format, using only CompacTape IV cartridges Valid with DLT4000, DLT7000, and DLT8000 drives
DLT35	35.0 GB	Uncompressed format, using only CompacTape IV cartridges Valid with DLT7000 and DLT8000 drives
DLT35C	See note 1. 70.0 GB	Compressed format, using only CompacTape IV cartridges Valid with DLT7000 and DLT8000 drives
DLT40	40.0 GB	Uncompressed format, using CompacTape IV cartridges Valid with a DLT8000 drive
DLT40C	See note 1. 80.0 GB	Compressed format, using CompacTape IV cartridges Valid with a DLT8000 drive
DLT2	80.0 GB	Uncompressed format, using Quantum DLT tape VS1 media
DLT2C	See note 1. 160.0 GB	Compressed format, using Quantum DLT tape VS1 media
DLT4	160.0 GB	Uncompressed format, using Quantum DLTtape VS1 cartridges. Valid with Quantum DLT-V4 drive
DLT4C	See note 1. 320.0 GB	Compressed format, using Quantum DLTtape VS1 cartridges. Valid with Quantum DLT-V4 drive
SDLT See note 2.	100.0 GB	Uncompressed format, using Super DLT Tape 1 cartridges Valid with a Super DLT drive
SDLTC See note 2.	See note 1. 200.0 GB	Compressed format, using Super DLT Tape 1 cartridges Valid with a Super DLT drive
SDLT320 See note 2.	160.0 GB	Uncompressed format, using Quantum SDLT I media Valid with a Super DLT drive
SDLT320C See note 2.	See note 1. 320.0 GB	Compressed format, using Quantum SDLT I media Valid with a Super DLT drive
SDLT600	300.0 GB	Uncompressed format, using SuperDLTtape-II media Valid with a Super DLT drive
SDLT600C	See note 1. 600.0 GB	Compressed format, using SuperDLTtape-II media Valid with a Super DLT drive
DLTS4	800 GB	Uncompressed format, using Quantum DLT S4 media. Valid with a DLT-S4 drive
DLTS4C	See note 1. 1.6 TB	Compressed format, using Quantum DLT S4 media. Valid with a DLT-S4 drive
Note: Depending on the effectiveness of compression, the actual capacity might be greater than the listed value. IBM® Tivoli® Storage Manager does not support a library that contains both Backward Read Compatible (BRC) SDLT and Non-Backward Read Compatible (NBRC) SDLT drives.

ESTCAPacity

Specifies the estimated capacity for the sequential access volumes that are categorized by this device class. This parameter is optional. You can specify this parameter if the default estimated capacity for the device class is inaccurate due to compression of data.

You must specify this value as an integer followed by K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 MB.

The smallest value that is allowed is 1 MB (that is, ESTCAPACITY=1M). To force the IBM Tivoli Storage Manager server to determine the estimated capacity for the volumes that are assigned to this device class, specify ESTCAPACITY="".

For more information about estimated capacities, see Table 1.

PREFIX

Specifies the high-level qualifier of the data set name that the server writes into the sequential access media labels. For each sequential access volume assigned to this device class, the server uses this prefix to create the data set name. This parameter is optional. The maximum length of this prefix is 8 characters.

If you previously established a media label naming convention that supports your current management system, consider the use of a volume prefix that conforms to your naming conventions.

MOUNTRetention

Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library that is managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

MOUNTWait

Specifies the maximum number of minutes the server waits for an operator to respond to a request to either mount a volume in a drive in a manual library or check in a volume to be mounted in an automated library. This parameter is optional. If the mount request is not satisfied within the specified amount of time, the mount request is canceled. You can specify a number from 0 to 9999.

MOUNTLimit

Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 4096.

If you plan to use the simultaneous-write function, ensure that sufficient drives are available for the write operation. If the number of drives needed for a simultaneous-write operation is greater than the value of the MOUNTLIMIT parameter for a device class, the transaction fails.

The following are possible values:

DRIVES: Specifies that every time a mount point is allocated, the number of drives that are defined to the library is used to calculate the true MOUNTLIMIT value (including online status).
Note: For EXTERNAL library types, do not specify DRIVES for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.
number: Specifies the maximum number of drives that are used concurrently in this device class by the server. This value must never exceed the number of drives that are defined and online in the library that services this device class.
0 (zero): Specifies that no new transactions can gain access to the storage pool. Any current transactions continue and complete, but new transactions are terminated.

Feedback