Administrator's Reference

DEFINE DEVCLASS (Define a Device Class)

Use the DEFINE DEVCLASS command to define a device class for storage pools.

You can use the UPDATE DEVCLASS and DELETE DEVCLASS commands to either modify or eliminate existing device classes. However, you cannot modify the device type of an existing device class. The DISK device class is predefined by ADSM and requires no user intervention. This also means that the DISK device class cannot be modified or eliminated via the UPDATE DEVCLASS or DELETE DEVCLASS command.

To avoid confusion, it is beneficial to define a unique device class to support the sequential access devices available at your installation. For more information on defining device classes, refer to the ADSM Administrator's Guide.

The server options file that is created during installation includes a DEVCONFIG option that specifies a default device configuration file named devcnfg.out. You can specify other device configuration files with additional DEVCONFIG options. When you use this option in the dsmserv.opt file, the files specified are automatically updated whenever a device class, library, or drive is selected, updated, or deleted.

The supported parameters for this command vary between device types; therefore, the syntax and parameter descriptions are provided according to the device type. The syntax and parameter information is presented in the following order:

FILE
SERVER
4MM
8MM
DLT
DTF
QIC
3590
3570
CARTRIDGE
ECARTRIDGE
GENERICTAPE
OPTICAL and WORM Types

The supported parameters for this command vary across device type. The following diagrams show the complete syntax for this command according to the device type.

Privilege Class

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

Syntax for DEFINE DEVCLASS, FILE

>>-DEFine DEVclass--devclassname---DEVType--=--FILE------------->
 
    .-MOUNTLimit--=--1-----------------.
>---+----------------------------------+------------------------>
    '-MOUNTLimit--=--mountlimitvalue---'
 
     .-MAXCAPacity--=--4M-------.
>----+--------------------------+------------------------------->
     '-MAXCAPacity--=--maxcap---'
 
     .-DIRectory--=--currentdirectory--.
>----+---------------------------------+-----------------------><
     '-DIRectory--=--dirname-----------'

Parameters for DEFINE DEVCLASS, FILE

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=FILE

Specifies that the FILE device type is assigned to the device class. This parameter is required. FILE indicates that a file or files are assigned to this device class. When the server needs to access a volume that belongs to this device class, it opens a file and reads or writes file data. A file is a form of sequential access media.

MOUNTLimit=mountlimitvalue

Specifies the maximum number of files that can be simultaneously open for input/output. This parameter is optional. The default value is 1. You can specify an integer in the range of 1 to 256, inclusive.

MAXCAPacity=maxcap

Specifies the maximum size of any data storage files defined to a storage pool categorized by this device class. This parameter is optional. You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, MAXCAPACITY=5M specifies that the maximum capacity for a volume in this device class is 5 megabytes. The default value is 4MB (that is, MAXCAPACITY=4M). The smallest value allowed is 100KB (that is, MAXCAPACITY=100K). The maximum value is 128GB.

DIRectory=dirname

Specifies the directory location of the file or files used in this device class. This parameter is optional. The default is the current working directory of the server at the time the command is issued, unless the DSMSERV_DIR environment variable has been set. For additional information about the DSMSERV_DIR variable, refer to ADSM Quick Start.

By specifying a directory name, you identify the location where the server places the files that represent storage volumes for this device class. While processing the command, the server expands the specified directory name into its fully qualified form, starting from the root directory.

Later, if the server needs to allocate a scratch volume, it creates a new file in this directory. For scratch volumes used to store client data, the file created by the server has a file name extension of .BFS. For scratch volumes used to store export data, a file name extension of .EXP is used. For example, suppose you define a device class with a DIRECTORY of /ADSMSTOR and the server needs a scratch volume in this device class to store export data, the file which the server creates might then be named /ADSMSTOR/00566497.EXP.

Syntax for DEFINE DEVCLASS, SERVER

>>-DEFine DEVclass--devclassname---DEVType--=--SERVER----------->
 
                                 .-MAXCAPacity--=--500M-----.
>---SERVERName--=--server name---+--------------------------+--->
                                 '-MAXCAPacity--=--maxcap---'
 
     .-MOUNTLimit--=--1-----------------.
>----+----------------------------------+----------------------->
     '-MOUNTLimit--=--mountlimitvalue---'
 
     .-MOUNTRetention--=--60--------------.
>----+------------------------------------+--------------------->
     '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM-----------.
>----+---------------------------+------------------------------>
     '-PREFIX--=--+-ADSM------+--'
                  '-volprefix-'
 
     .-RETRYPeriod--=--10--------------------.
>----+---------------------------------------+------------------>
     '-RETRYPeriod--=--retryvalue(minutes)---'
 
     .-RETRYInterval--=--30--------------------.
>----+-----------------------------------------+---------------><
     '-RETRYInterval--=--retryvalue(seconds)---'

Parameters for DEFINE DEVCLASS, SERVER

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=SERVER

A device type of SERVER indicates a remote connection that supports virtual volumes.

SERVERName=servername

The SERVERNAME parameter MUST match a defined server.

Care should be taken when changing the SERVERNAME because if this refers to a new server, virtual volumes residing on the old server will not be accessible using this device class.

MAXCAPacity=maxcap

Specifies the maximum size that objects can be when created on the target server; the default for this value is 500M. This parameter is optional. You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, MAXCAPACITY=5M specifies that the maximum capacity for a volume in this device class is 5 megabytes. The default value is 500M (that is, MAXCAPACITY=500M). The smallest value allowed is 100KB (that is, MAXCAPACITY=100K).

MOUNTLimit=mountlimitvalue

Specifies the maximum number of volumes that can be simultaneously open for input/output. This parameter is optional. The default value is 1. You can specify an integer in the range of 1 to 256, inclusive.

MOUNTRetention=mountretvalue

Specifies the amount of time, in minutes, to retain an idle connection with the target server before closing the connection. This parameter is optional. The default value is 60. You can specify an integer in the range of 0 to 9999, inclusive.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online.

PREFIX=volprefix

Specifies the beginning portion of the high-level archive file name on the target server. This parameter is optional. The default value is ADSM. The maximum length of this prefix is 8 characters.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a high level archive file name using the default prefix, with an ADSM qualifier added, is ADSM.volume1.

RETRYPeriod=retryvalue(minutes)

Specifies the retry period in minutes. The retry period is the interval over which the server should attempt to contact a target server in the event that there is a suspected communications failure. This parameter is optional. The default value is 10 minutes.

RETRYInterval=retryvalue(seconds)

Specifies the retry period in seconds. The retry interval is how often the retries are done within a given retry period. This parameter is optional. The default value is 30 seconds.

Syntax for DEFINE DEVCLASS, 4MM

>>-DEFine DEVclass--devclassname---DEVType--=--4MM-------------->
 
    .-FORMAT--=--DRIVE------.
>---+-----------------------+-LIBRary--=--libraryname----------->
    '-FORMAT--=--+-DRIVE-+--'
                 +-DDS1--+
                 +-DDS1C-+
                 +-DDS2--+
                 +-DDS2C-+
                 +-DDS3--+
                 '-DDS3C-'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, 4MM

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=4MM

Specifies that the 4MM device type is assigned to the device class. This parameter is required. 4MM indicates that 4mm tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE. Tape capacities are provided using their uncompressed values; hardware compression significantly increases these capacity values.

The following are possible values for 4mm devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

Attention: Avoid specifying the DRIVE value when a mixture of devices is used within the same library. For example, if you have drives that support recording formats superior to other drives in a library, do not specify the FORMAT=DRIVE option.

DDS1

Specifies that ADSM writes data using the DDS-1 recording format for 4mm tapes, without compression. This format results in an uncompressed cartridge capacity of 1.3GB on 60 meter tape or 2GB on 90 meter tape. This format only applies to 60 and 90 meter tapes.

DDS1C

Specifies that ADSM writes data using the DDS-1 recording format for 4mm tapes, with compression enabled. This results in a cartridge capacity of approximately 1.3GB on a 60 meter tape or 2GB on a 90 meter tape. This format, however, uses the tape drive hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression. This format only applies to 60 and 90 meter tapes.

DDS2

Specifies that ADSM writes data using the DDS-2 recording format for 4mm tapes, without compression. This format results in a cartridge capacity of 4GB on 120 meter tape. This format only applies to 120 meter tape.

DDS2C

Specifies that ADSM writes data using the DDS-2 recording format for 4mm tapes, with compression. This format results in a cartridge capacity of approximately 8GB on 120 meter tape. This format, however, uses the tape drive hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression. This format only applies to 120 meter tape.

DDS3

Specifies that ADSM writes data using the DDS-3 recording format for 4mm tapes, without compression. This format results in a cartridge capacity of 12GB on 125 meter tape. This format only applies to 125 meter tape.

DDS3C

Specifies that ADSM writes data using the DDS-3 recording format for 4mm tapes, with compression. This format results in a cartridge capacity of approximately 24GB on 125 meter tape. This format, however, uses the tape drive hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression. This format only applies to 125 meter tape.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

Specifies the amount of time, in minutes, to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. You can specify an integer in the range of 0 to 9999, inclusive.

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 managed by an external media management system) setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

PREFIX=tapevolprefix

Specifies the high level qualifier of the file name that the server writes into the sequential access media labels. For each sequential access volume assigned to this device class, ADSM 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 already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on the default estimated capacity for 4mm tapes, see Table 40.

Table 40. ADSM Default Estimated Capacity for 4mm Tape

Tape Format Estimated Capacity
DDS1 2.0GB
DDS1C 2.0GB (see note)
DDS2 4.0GB
DDS2C 4.0GB (see note)
DDS3 12.0GB
DDS3C 24.0GB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

Specifies the maximum length of time, in minutes, to wait for a sequential access volume to be mounted. This parameter is optional and does not apply to sequential access media libraries. 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 an integer in the range of 0 to 9999, inclusive.

MOUNTLimit=mountlimitvalue

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 an integer in the range of 0 to 256, inclusive.

Note:

For external libraries you should not use the value of DRIVES (do not allow the default of MOUNTLIMIT to be used). You need to specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, 8MM

>>-DEFine DEVclass--devclassname---DEVType--=--8MM-------------->
 
    .-FORMAT--=--DRIVE------.
>---+-----------------------+-LIBRary--=--libraryname----------->
    '-FORMAT--=--+-DRIVE-+--'
                 +-8200--+
                 +-8200C-+
                 +-8500--+
                 +-8500C-+
                 +-8900--+
                 +-8900C-+
                 +-AIT---+
                 '-AITC--'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, 8MM

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=8MM

Specifies that the 8MM device type is assigned to the device class. This parameter is required. 8MM indicates that 8mm tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

Possible values for 8mm devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

8200

Specifies that ADSM writes data using the 8200 recording format. This results in a tape capacity of 2.3GB when using standard 112M tape cartridges.

8200C

Specifies that ADSM writes data using the 8200C recording format. This results in a tape capacity of approximately 2.3GB when using standard 112 meter tape cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater than 2.3GB, depending on the effectiveness of the compression feature.

8500

Specifies that ADSM writes data using the 8500 recording format. This results in a tape capacity of 5.0GB when using standard 112M tape cartridges.

8500C

Specifies that ADSM writes data using the 8500C recording format. This results in a tape capacity of at least 5.0GB when using standard 112M tape cartridges. However, this format uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 5.0GB, depending on the effectiveness of the compression feature.

8900

Specifies that ADSM writes data using the 8900 recording format. This results in a tape capacity of 5.0GB when using standard 112M tape cartridges.

8900C

Specifies that ADSM writes data using the 8900 recording format. This results in a tape capacity of 10.0GB when using standard 112M tape cartridges.

AIT

Specifies that ADSM writes data using the AIT recording format. This results in a tape capacity of at least 25.0GB when using Sony's T3N cartridges.

AITC

Specifies that ADSM writes data using the AITC recording format. This results in a tape capacity of at least 60.0GB when using Sony's T3N cartridges. This format uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 60.0GB, depending on the effectiveness of the compression.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

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, ADSM 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 already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

Table 41. ADSM Default Estimated Capacity for 8mm Tape

Tape Format Estimated Capacity
8200 2.3GB
8200C 2.3GB (see note)
8500 5.0GB
8500C 5.0GB (see note)
8900 5.0GB
8900C 10.0GB
AIT 25.0GB
AITC 60.0GB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, DLT

>>-DEFine DEVclass--devclassname---DEVType--=--DLT-------------->
 
    .-FORMAT--=--DRIVE-------.
>---+------------------------+-LIBRary--=--libraryname---------->
    '-FORMAT--=--+-DRIVE--+--'
                 +-DLT10--+
                 +-DLT10C-+
                 +-DLT15--+
                 +-DLT15C-+
                 +-DLT20--+
                 +-DLT20C-+
                 +-DLT30--+
                 +-DLT30C-+
                 +-DLT35--+
                 '-DLT35C-'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, DLT

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=DLT

Specifies that the DLT device type is assigned to the device class. This parameter is required. DLT indicates that DLT tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

These are the possible values for DLT devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

DLT10

Specifies that ADSM writes data using the DLT10 recording format. This results in a tape capacity of approximately 10.0GB when using CompacTape III or CompacTape IV cartridges.

DLT10C

Specifies that ADSM writes data using the DLT10C recording format. This results in a tape capacity of approximately 20.0GB when using CompacTape III and CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater than 20.0GB, depending on the effectiveness of the compression feature.

DLT15

Specifies that ADSM writes data using the DLT15 recording format. This results in a tape capacity of approximately 15.0GB when using CompacTape III or CompacTape IV cartridges

Attention: DLT15 and DLT15C can only be used on CompacTape IIIxt or IV cartridges, not CompacTape III. DLT15 and DLT15C are only valid with DLT2000XT, DLT4000 and DLT7000.

DLT15C

Specifies that ADSM writes data using the DLT15C recording format. This results in a tape capacity of approximately 30.0GB when using CompacTape III or CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater than 30.0GB, depending on the effectiveness of the compression feature.

Attention: DLT15 and DLT15C can only be used on CompacTape IIIxt or IV cartridges, not CompacTape III. DLT15 and DLT15C are only valid with DLT2000XT, DLT4000 and DLT7000.

DLT20

Specifies that ADSM writes data using the DLT20 recording format. This results in a tape capacity of approximately 20.0GB when using CompacTape IV cartridges.

Attention: The DLT20 format can only be used with CompacTape IV cartridges in a DLT4000 and DLT7000 drive.

DLT20C

Specifies that ADSM writes data using the DLT20C recording format. This results in a tape capacity of approximately 40.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 40.0GB, depending on the effectiveness of the compression feature.

Attention: The DLT20 format can only be used with CompacTape IV cartridges in a DLT4000 and DLT7000 drive.

DLT30

Specifies that ADSM writes data using the DLT30 recording format. This results in a tape capacity of approximately 30.0GB when using CompacTape IV cartridges.

Attention: DLT30 and DLT30C can only be used with CompacTape IV cartridges.

DLT30C

Specifies that ADSM writes data using the DLT30C recording format. This results in a tape capacity of approximately 70.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 70.0GB, depending on the effectiveness of the compression feature.

Attention: DLT30 and DLT30C can only be used with CompacTape IV cartridges.

DLT35

Specifies that ADSM writes data using the DLT35 recording format. This results in a tape capacity of approximately 35.0GB when using CompacTape IV cartridges.

Attention:
DLT35 and DLT35C can only be used with CompacTape IV cartridges.

DLT35C

Specifies that ADSM writes data using the DLT35C recording format. This results in a tape capacity of approximately 70.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 70.0GB, depending on the effectiveness of the compression feature.

Attention:
DLT35 and DLT35C can only be used with CompacTape IV cartridges.

LIBRary=libraryname

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.

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

Table 42. ADSM Default Estimated Capacity for DLT

Tape Format Estimated Capacity
DLT10 10.0GB
DLT10C 10.0GB (see note)
DLT15 15.0GB
DLT15C 15.0GB (see note)
DLT20 20.0GB
DLT20C 20.0GB (see note)
DLT30 35.0GB
DLT30C 70.0GB (see note)
DLT35 35.0GB
DLT35C 70.0GB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, DTF

>>-DEFine DEVclass--devclassname---DEVType--=--DTF-------------->
 
>---FORMAT--=--+-DRIVE-+-LIBRary--=--libraryname---------------->
               '-DTF---'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, DTF

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=DTF

Specifies that the DTF tape devices are assigned to this device class. This parameter is required.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

These are the possible values for DTF devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

DTF

Specifies that ADSM writes data to a DTF drive using the DTF recording format. This results in a tape capacity of approximately 12GB with the CY-9000 GW-240 and 42GB with the CY-9000 GW-730L tape cassette.

LIBRary=libraryname

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.

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, QIC

>>-DEFine DEVclass--devclassname---DEVType--=--QIC-------------->
 
    .-FORMAT--=--DRIVE--------.
>---+-------------------------+-LIBRary--=--libraryname--------->
    '-FORMAT--=--+-DRIVE---+--'
                 +-QIC120--+
                 +-QIC150--+
                 +-QIC525--+
                 +-QIC1000-+
                 '-QIC2000-'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, QIC

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=QIC

Specifies that the QIC device type is assigned to the device class. This parameter is required. QIC indicates that quarter-inch cartridge tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

The following are possible values for QIC devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

QIC120

See Table 43.

QIC150

See Table 43.

QIC525

See Table 43.

QIC1000

See Table 43.

QIC2000

See Table 43.

Table 43. QIC Tape Recording Format Selections

Tape/Format

QIC-120

QIC-150

QIC-525

QIC-1000

QIC-2000

3M DC300XLP 3M DC600A 3M DC600XTD 3M DC6150 3M DC6320 3M DC6525 3M DC9100 3M DC9120XL

- Read Read/Write Read/Write Read/Write Read/Write - -

- - Read/Write Read/Write Read/Write Read/Write - -

- - - - Read/Write Read/Write - -

- - - - - - Read/Write Read/Write

- - - - - - Read/Write Read/Write

Note: ADSM cannot use 3M DC300XLP and 3M DC600A tapes.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

Specifies the estimated capacity for the sequential access volumes 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 a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on the default estimated capacity for QIC tapes, see Table 44.

Table 44. ADSM Default Estimated Capacity for QIC Tape

Tape Format Estimated Capacity (range)
QIC120 26MB-172MB
QIC150 31MB-207MB
QIC525 65MB-427MB
QIC1000 169MB-1.1GB
QIC2000 2.0GB

MOUNTWait=mountwaitvalue

Tape Format	Estimated Capacity (range)
QIC120	26MB-172MB
QIC150	31MB-207MB
QIC525	65MB-427MB
QIC1000	169MB-1.1GB
QIC2000	2.0GB

Specifies the maximum length of time, in minutes, to wait for a sequential access volume to be mounted. 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 an integer in the range of 0 to 9999, inclusive.

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, 3590

>>-DEFine DEVclass--devclassname---DEVType--=--3590------------->
 
    .-FORMAT--=--DRIVE--------------------.
>---+-------------------------------------+--------------------->
    '-FORMAT--=----DRIVE---3590B--3590C---'
 
>---LIBRary--=--libraryname------------------------------------->
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, 3590

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=3590

Specifies the 3590 device type is assigned to the device class. This parameter is required. 3590 indicates that IBM 3590 cartridge tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

The following are possible values for 3590 devices:

DRIVE: Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
3590B: Specifies that ADSM writes data using the basic (uncompressed) format. This results in a tape capacity of approximately 10GB.
3590C: Specifies that ADSM writes data using the compressed format. This results in a tape capacity of approximately 10GB. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

Table 45. ADSM Estimated Capacity for 3590 Cartridge Tape

Tape Format Estimated Capacity
3590B 10GB
3590C 10GB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default value is 1. You can specify an integer in the range of 1 to 256, inclusive. This value should be equal to the number of drives available to this device class.

If this value is set to 1, then it may not be possible for media-to-media operations (like reclamation) to work.

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, 3570

>>-DEFine DEVclass--devclassname---DEVType--=--3570------------->
 
    .-FORMAT--=--DRIVE------.
>---+-----------------------+-LIBRary--=--libraryname----------->
    '-FORMAT--=--+-DRIVE-+--'
                 +-3570B-+
                 '-3570C-'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, 3570

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=3570

Specifies the 3570 device type is assigned to the device class. This parameter is required. 3570 indicates that IBM 3570 cartridge tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

The following are possible values for 3570 devices:

DRIVE: Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
3570B: Specifies that ADSM writes data using the basic (uncompressed) format. This results in a tape capacity of approximately 5GB.
3570C: Specifies that ADSM writes data using the compressed format. This results in a tape capacity of approximately 5GB. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value is to be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix, with an ADSM qualifier added, is ADSM.BFS.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on the default estimated capacity for 3570 cartridge tapes, see Table 46.

Table 46. ADSM Estimated Capacity for 3570 Cartridge Tape

Tape Format Estimated Capacity
3570B 5GB
3570C 5GB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, CARTRIDGE

>>-DEFine DEVclass--devclassname---DEVType--=--CARTridge-------->
 
    .-FORMAT--=--DRIVE-------.
>---+------------------------+-LIBRary--=--libraryname---------->
    '-FORMAT--=--+-DRIVE--+--'
                 +-3480---+
                 +-3480XF-+
                 +-3490B--+
                 '-3490C--'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, CARTRIDGE

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=CARTridge

Specifies that the CARTRIDGE device type is assigned to the device class. This parameter is required. CARTRIDGE indicates that cartridge tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

There are five possible values for CARTRIDGE devices:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

Attention: Avoid specifying DRIVE when a mixture of devices is used within the same library. For example, if you have drives that support recording formats superior to other drives in a library, do not specify the FORMAT=DRIVE option. If you specify DRIVE for a device class that has non-compatible sequential access devices, then you must mount volumes on devices that are capable of reading or writing at the format established when the volume was first mounted. This can cause delays if the only sequential access device that can access the volume is already in use.

3480

Specifies 3480 Basic recording format (18 track).

3480XF

Specifies 3480 Compacted recording format (18 track).

3490B

Specifies 3490 Basic recording format (36 track).

3490C

Specifies 3490 Compacted recording format (36 track).

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

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, ADSM uses this prefix to create the data set name. This parameter is optional. The default value is ADSM.

If you have already established a tape label naming convention that supports your current tape management system, use a tape volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value must be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
      AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

ADSM.BFS is an example of a tape volume filename using the default prefix and an added ADSM qualifier.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on the default estimated capacity for cartridge tapes, see Table 47.

Table 47. ADSM Estimated Capacity for Cartridge Tape

Tape Format Media Type Estimated Capacity
3480 CST 180MB
3480XF CST 180MB (see note)
3490B CST 360MB
3490C CST 360MB (see note)
3490B ECCST 720MB
3490C ECCST 720MB (see note)

Note: This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, ECARTRIDGE

>>-DEFine DEVclass--devclassname---DEVType--=--ECARTridge------->
 
    .-FORMAT--=--DRIVE------.
>---+-----------------------+-LIBRary--=--libraryname----------->
    '-FORMAT--=--+-DRIVE-+--'
                 +-18T---+
                 +-18TC--+
                 +-36T---+
                 +-36TC--+
                 +-SD3A--+
                 +-SD3AC-+
                 +-SD3B--+
                 +-SD3BC-+
                 +-SD3C--+
                 '-SD3CC-'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
     .-PREFIX--=--ADSM---------------.
>----+-------------------------------+-------------------------->
     '-PREFIX--=--+-ADSM----------+--'
                  '-tapevolprefix-'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

Parameters for DEFINE DEVCLASS, ECARTRIDGE

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=ECARTridge

Specifies that the ECARTRIDGE device type is assigned to the device class. This parameter is required. ECARTRIDGE indicates that cartridge tape devices are assigned to this device class.

FORMAT=tapeformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

Possible values for ECARTRIDGE devices are :

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

18T

Specifies the 18 track standard (read-only) recording format.

18TC

Specifies the 18 track extended (read-only), compacted recording format.

36T

Specifies the 36 track extended (read and write) recording format.

36TC

Specifies the 36 track extended (read and write), compacted recording format.

SD3A

Specifies a 10GB 'A' cartridge with 91 meters (298 feet) of tape with a standard recording format.

SD3AC

Specifies a 10GB 'A' cartridge with 91 meters (298 feet) of tape with a compacted recording format.

SD3B

Specifies a 25GB 'B' cartridge with 204 meters (668 feet) of tape with a standard recording format.

SD3BC

Specifies a 25GB 'B' cartridge with 204 meters (668 feet) of tape with a compacted recording format.

SD3C

Specifies a 50GB 'B' cartridge with 392 meters (1286 feet) of tape with a standard recording format.

SD3CC

Specifies a 50GB 'B' cartridge with 392 meters (1286 feet) of tape with a compacted recording format.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

PREFIX=tapevolprefix

If you have already established a tape label naming convention that supports your current tape management system, use a tape volume prefix that conforms to your naming conventions.

Values specified for this parameter must meet the following conditions:

The value must be made up of qualifiers, which can contain up to 8 characters (including periods). For example, the following value would be acceptable:
```
      AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetical or national (@,#,$), followed by alphabetical, national, hyphen, or numeric characters.

ADSM.BFS is an example of a tape volume filename using the default prefix and an added ADSM qualifier.

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on the default estimated capacity for cartridge tapes, see Table 48.

Table 48. ADSM Estimated Capacity for Cartridge Tape

Tape Format Estimated Capacity
18T 360MB
36T 720MB
SD3A 10GB
SD3B 25GB
SD3C 50GB

Note: Some formats use a tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be double or more than the listed value.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, GENERICTAPE

>>-DEFine DEVclass--devclassname---DEVType--=--GENERICTAPE------>
 
>--LIBRary--=--libraryname-------------------------------------->
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

When using this device type, the server does not recognize either the type of device (for example, 4mm, 8mm, or DLT) or the cartridge recording format. Since the server does not recognize the type of device, if an I/O error occurs, error information is less detailed compared to error information for a specific device type (for example, 8mm).

When defining devices to the server do not mix various types of devices within the same device type. For example, by having both 4mm and 8mm tape devices defined within the same GENERICTAPE device type, it is possible that the server could attempt mounting a 4mm cartridge in an 8mm tape device.

Parameters for DEFINE DEVCLASS, GENERICTAPE

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=GENERICTAPE

Specifies that the GENERICTAPE device type is assigned to the device class. This parameter is required. GENERICTAPE indicates that the volumes for this device class are used in tape drives supported by a Windows NT tape device driver.

The server recognizes that the media can be removed and that additional media can be inserted, subject to limits set with the MOUNTLIMIT parameter for the device class and the MAXSCRATCH parameter for the storage pool.

Volumes in a device class with device type GENERICTAPE are sequential access volumes.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online.

ESTCAPacity=admindefined

Specifies the estimated capacity for the sequential access volumes categorized by this device class. This parameter is optional.

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

Specify a capacity appropriate to the particular tape drive being used.

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Syntax for DEFINE DEVCLASS, OPTICAL and WORM Types

>>-DEFine DEVclass--devclassname---DEVType--=--+-OPTical------+->
                                               +-WORM---------+
                                               |        (1)   |
                                               +-WORM12-------+
                                               |        (1)   |
                                               '-WORM14-------'
 
    .-FORMAT--=--DRIVE--------------.
>---+-------------------------------+-LIBRary--=--libraryname--->
    '-FORMAT--=--+-DRIVE---------+--'
                 |       (2)     |
                 +-650MB---------+
                 |        (2)    |
                 +-1300MB--------+
                 |        (2)    |
                 +-2600MB--------+
                 |        (3)    |
                 +-5600MB--------+
                 |         (4)   |
                 +-10200MB-------+
                 |         (3)   |
                 +-12000MB-------+
                 |         (4)   |
                 '-14800MB-------'
 
    .-MOUNTRetention--=--60--------------.
>---+------------------------------------+---------------------->
    '-MOUNTRetention--=--mountretvalue---'
 
>----+-------------------------------+-------------------------->
     '-ESTCAPacity--=--admindefined--'
 
    .-MOUNTWait--=--60---------------.
>---+--------------------------------+-------------------------->
    '-MOUNTWait--=--mountwaitvalue---'
 
     .-MOUNTLimit--=--DRIVES---------------.
>----+-------------------------------------+-------------------><
     '-MOUNTLimit--=--+-DRIVES----------+--'
                      +-mountlimitvalue-+
                      '-0---------------'

1	The WORM12 or WORM14 device type is only valid on AIX 4.1.4 or subsequent systems.
2	This value is not valid for WORM12 device types.
3	This value is only valid for WORM12 device types.
4	This value is only valid for WORM14 device types.

Parameters for DEFINE DEVCLASS, OPTICAL and WORM Types

devclassname

Specifies the name of the device class to be defined. This parameter is required. The maximum length of the device class name is 30 characters.

DEVType=optictype

Specifies that the OPTICAL and WORM, WORM12, WORM14 device types are assigned to the device class. This parameter is required.

Possible values are:

OPTical: Specifies that the device class uses two-sided 5.25 inch rewritable optical media.
WORM: Specifies that the device class uses two-sided 5.25 inch write-once read-many (WORM) optical media.
WORM12: Specifies that the device class uses two-sided 12 inch WORM optical media. The WORM12 device type is only valid on AIX 4.1.4 or subsequent systems.
WORM14: Specifies that the device class uses two-sided 14 inch WORM optical media. The WORM14 device type is only valid on AIX 4.1.4 or subsequent systems.

FORMAT=optformat

Specifies the recording format to be used when writing data to sequential access media. This parameter is optional; the default value is DRIVE.

Possible values are:

DRIVE

Specifies that ADSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

650MB

Specifies that ADSM writes data to a 650 MB 5.25-inch optical drive. This value is not valid for WORM12 or 14 device types.

1300MB

Specifies that ADSM writes data to a 1300 MB 5.25-inch optical drive.This value is not valid for WORM12 or 14 device types.

2600MB

Specifies that ADSM writes data to a 2600 MB 5.25-inch optical drive. This value is not valid for WORM12 or 14 device types.

5600MB

Specifies that ADSM writes data to a 5600 MB 12-inch optical drive. This value is only valid for WORM12 device types.

10200MB

Specifies that ADSM writes data to a 10200 MB 14-inch optical drive. This value is only valid for WORM14 device types.

12000MB

Specifies that ADSM writes data to a 12000 MB 12-inch optical drive. This value is only valid for WORM12 device types.

14800MB

Specifies that ADSM writes data to a 14800 MB 14-inch optical drive. This value is only valid for WORM14 device types.

LIBRary=libraryname

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

MOUNTRetention=mountretvalue

ESTCAPacity=admindefined

You must specify this value as an integer followed by a scale factor. The following are possible scale factors:

Symbol: Symbol Name
K: Kilobyte
M: Megabyte
G: Gigabyte

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes. The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

MOUNTWait=mountwaitvalue

MOUNTLimit=mountlimitvalue

Note:

The following are possible values:

DRIVES: The mountlimit value of DRIVES is used to indicate that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mountlimit value, (including taking into account whether each is online).
mountlimitvalue: This will have the effect of specifying the maximum number of drives used concurrently in this device class by ADSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.
0: The value of zero prevents new transactions from gaining access to the storage pool.

Examples

Task 1

Define a device class named PLAINFILES with a file device type and a maximum capacity of 50MB.

Command:: define devclass plainfiles devtype=file maxcapacity=50m

Task 2

Define a device class named 8MMTAPE for an 8mm device in a library named AUTO. The format is DRIVE, mount limit is 2, mount retention is 10, tape volume prefix is named ADSMVOL, and the estimated capacity is 6GB.

Command:: define devclass 8mmtape devtype=8mm library=auto format=drive mountlimit=2 mountretention=10 prefix=adsmvol estcapacity=6G

Related Commands

Table 49. Commands Related to DEFINE DEVCLASS

Command Description
BACKUP DEVCONFIG Backs up ADSM device information to a file.
DEFINE LIBRARY Defines an automated or manual library.
DELETE DEVCLASS Deletes a device class name.
QUERY DEVCLASS Displays information about one or more device classes.
UPDATE DEVCLASS Changes the attributes of a device class.

Command	Description
BACKUP DEVCONFIG	Backs up ADSM device information to a file.
DEFINE LIBRARY	Defines an automated or manual library.
DELETE DEVCLASS	Deletes a device class name.
QUERY DEVCLASS	Displays information about one or more device classes.
UPDATE DEVCLASS	Changes the attributes of a device class.

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