DEFINE DEVCLASS (Define 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

Read syntax diagramSkip visual syntax diagram
>>-DEFine DEVclass--device_class_name--------------------------->

>--LIBRary--=--library_name--DEVType--=--DLT-------------------->

   .-WORM--=--No------.  .-FORMAT--=--DRIVE--------.   
>--+------------------+--+-------------------------+------------>
   '-WORM--=--+-No--+-'  '-FORMAT--=--+-DRIVE----+-'   
              '-Yes-'                 +-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-------------------.   
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'   
                '-tape_volume_prefix-'     

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

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

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined. The maximum length of the device class name is 30 characters.
LIBRary (Required)
Specifies the name of the defined library object that contains the DLT tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.
DEVType=DLT (Required)
Specifies that the DLT device type is assigned to the device class. DLT indicates that DLT tape devices are assigned to this device class.
WORM
Specifies whether the drives use WORM (write once, read many) media. This parameter is optional. The default is No. The field can contain one of the following values:
Yes
Specifies that the drives use WORM media.
No
Specifies that the drives do not use WORM media.
Note: Support for DLT WORM media is available only for SDLT-600, Quantum DLT-V4, and Quantum DLT-S4 drives in manual, SCSI, and ACSLS libraries.
FORMAT
Specifies the recording format to be used when data is written to sequential access media. This parameter is optional. The default value is DRIVE.

If the drives are in a library that includes drives of different tape technology, do not use the DRIVE value. Use the specific format that the drives use.

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 cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT1C

See note 1.

80.0 GB

Compressed format, using only CompacTape III cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT10 10.0 GB Uncompressed format, using only CompacTape III cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT10C

See note 1.

20.0 GB

Compressed format, using only CompacTape III cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT15 15.0 GB Uncompressed format, using only CompacTape IIIxt cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT15C

See note 1.

30.0 GB

Compressed format, using only CompacTape IIIxt cartridges

Valid with DLT4000, DLT7000, and DLT8000 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:
  1. Depending on the effectiveness of compression, the actual capacity might be greater than the listed value.
  2. 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 volumes that are assigned to 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 one of the following unit indicators: K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). The smallest value that is accepted is 1 MB (ESTCAPACITY=1M).

For example, specify that the estimated capacity is 9 GB with the parameter ESTCAPACITY=9G.

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 default value is ADSM. The maximum length of this prefix is 8 characters.

If you have a naming convention for media labels to support your current management system, use a volume prefix that conforms to your naming conventions.

Values that are specified for this parameter must meet the following conditions:
  • The value is to be made up of qualifiers, which can be a maximum of eight characters including periods. For example, the following value is acceptable:
         AB.CD2.E
  • The qualifiers must be separated by a single period.
  • The first letter of each qualifier must be alphabetic or national (@,#,$), followed by alphabetic, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix is ADSM.BFS.

MOUNTRetention
Specifies the number of minutes that an idle sequential access volume is retained before it is dismounted. This parameter is optional. The default value is 60 minutes. You can specify a number 0 - 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.

Note: For environments in which devices are shared across storage applications, the MOUNTRETENTION setting must be carefully considered. This parameter determines how long an idle volume remains in a drive. Some media managers do not dismount an allocated drive to satisfy pending requests. You might need to tune this parameter to satisfy competing mount requests while maintaining optimal system performance. Typically, problems arise more frequently when the MOUNTRETENTION parameter is set to a value that is too small, for example, zero.
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. The default value is 60 minutes. You can specify a number 0 - 9999.
MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number 0 - 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 and online in the library is used to calculate the true value.
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 in this device class that are used concurrently 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.