Tivoli Header

Administrator's Reference


DEFINE DEVCLASS (Define a Device Class)

Use this command to define a device class.

Note:
The DISK device class is defined by Tivoli Storage Manager and cannot be modified with the DEFINE DEVCLASS command.

The syntax and parameter descriptions are provided according to the device type. The syntax and parameter information is presented in the following order:

DEFINE DEVCLASS -- 3570

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--3570------------------->
 
   .-FORMAT--=--DRIVE-----.
>--+----------------------+--+----------------------+----------->
   '-FORMAT--=--+-DRIVE-+-'  '-ESTCAPacity--=--size-'
                +-3570B-+
                '-3570C-'
 
   .-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 tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=3570 (Required)
Specifies the 3570 device type is assigned to the device class. The 3570 indicates that IBM 3570 cartridge tape devices are assigned to this device class.

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

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

Table 51. Recording Format and Default Estimated Capacity for 3570 Tape Volumes

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 containing some drives that support recording formats superior to other drives.

3570B 5.0GB Uncompressed (basic) format
3570C

See note

10.0GB

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

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

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

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

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

MOUNTRetention
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 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, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- 3590

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--3590------------------->
 
   .-FORMAT--=--DRIVE-------.
>--+------------------------+--+----------------------+--------->
   '-FORMAT--=--+-DRIVE---+-'  '-ESTCAPacity--=--size-'
                +-3590B---+
                +-3590C---+
                +-3590E-B-+
                '-3590E-C-'
 
   .-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 tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=3590 (Required)
Specifies the 3590 device type is assigned to the device class. 3590 indicates that IBM 3590 cartridge tape devices are assigned to this device class.

FORMAT
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 tables list the recording formats, estimated capacities and recording format options for 3590 devices:

Table 52. Recording Formats and Default Estimated Capacities for 3590

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 containing some drives that support recording formats superior to other drives.

3590B 10.0GB Uncompressed (basic) format
3590C

See note

20.0GB

Compressed format
3590E-B 10.0GB Uncompressed (basic) format, similar to the 3590B format
3590E-C

See note

20.0GB

Compressed format, similar to the 3590C format
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.


Table 53. 3590 Device Recording Format Selections

Device\Format
3590B
3590C
3590E-B
3590E-C
3590B
Ultra SCSI
3590E
Read/Write
Read/Write
Read
Read/Write
Read/Write
Read
-
-
Read/Write
-
-
Read/Write

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

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

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

MOUNTRetention
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 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, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- 4MM

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--4MM-------------------->
 
   .-FORMAT--=--DRIVE-----.
>--+----------------------+--+----------------------+----------->
   '-FORMAT--=--+-DRIVE-+-'  '-ESTCAPacity--=--size-'
                +-DDS1--+
                +-DDS1C-+
                +-DDS2--+
                +-DDS2C-+
                +-DDS3--+
                +-DDS3C-+
                +-DDS4--+
                '-DDS4C-'
 
   .-PREFIX--=--ADSM-------------------.
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
   .-MOUNTWait--=--60------.  .-MOUNTRetention--=--60------.
>--+-----------------------+--+----------------------------+---->
   '-MOUNTWait--=--minutes-'  '-MOUNTRetention--=--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 4mm tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=4MM (Required)
Specifies that the 4MM device type is assigned to the device class. The 4MM indicates that 4mm tape devices are assigned to this device class.

FORMAT
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 table lists the recording formats and estimated capacities for 4mm devices:

Table 54. Recording Formats and Default Estimated Capacities for 4mm Tapes

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 containing some drives that support recording formats superior to other drives.

DDS1 2.6GB (60-meter)

4.0GB (90-meter)

Uncompressed format, only applies to 60-meter and 90-meter tapes
DDS1C

See note

1.3GB (60-meter)

2.0GB (90-meter)

Compressed format, only applies to 60-meter and 90-meter tapes
DDS2 4.0GB Uncompressed format, only applies to 120-meter tapes
DDS2C

See note

8.0GB

Compressed format, only applies to 120-meter tapes
DDS3 12.0GB Uncompressed format, only applies to 125-meter tapes
DDS3C

See note

24.0GB

Compressed format, only applies to 125-meter tapes
DDS4 20.0GB Uncompressed format, only applies to 150-meter tapes
DDS4C

See note

40.0GB

Compressed format, only applies to 150-meter tapes
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.

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

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

PREFIX
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, 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 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:

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives 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 transaction will continue and complete but new transactions will be terminated.

DEFINE DEVCLASS -- 8MM

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--8MM-------------------->
 
   .-FORMAT--=--DRIVE-----.
>--+----------------------+--+----------------------+----------->
   '-FORMAT--=--+-DRIVE-+-'  '-ESTCAPacity--=--size-'
                +-8200--+
                +-8200C-+
                +-8500--+
                +-8500C-+
                +-8900--+
                +-AIT---+
                +-AITC--+
                +-M2----+
                '-M2C---'
 
   .-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 8mm tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=8MM (Required)
Specifies that the 8MM device type is assigned to the device class. 8MM indicates that 8mm tape devices are assigned to this device class.

FORMAT
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 table lists the recording formats and estimated capacities for 8mm devices:

Table 55. Recording Format and Default Estimated Capacity for 8mm Tape

Format
Tape Length
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 containing some drives that support recording formats superior to other drives.

8200 2.3GB Uncompressed (standard) format, using standard 112-meter tape cartridges
8200C

See note

3.5GB

4.6GB

Compressed (standard) format, using standard 112-meter tape cartridges
8500
15m



54m



112m



160m XL

See note
600MB
600MB
600MB
2.35GB
2.35GB
2.35GB
5GB or 10.0GB
5GB or 10.0GB
5GB or 10.0GB
7GB
Drives (Read Write)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
8500C
15m



54m



112m



160m XL

See note
1.2GB
1.2GB
1.2GB
4.7GB
4.7GB
4.7GB
5GB or 10.0GB
5GB or 10.0GB
5GB or 10.0GB
7GB
Drives (Read Write)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
Exabyte 8500/8500C (RW)
Exabyte 8505 (RW)
Eliant 820 (RW)
8900
15m
54m
112m
160m XL
22m
125m
170m
See note
-
-
-
-
2.5 GB
-
40 GB
Drive (Read Write)
Mammoth 8900 (R)
Mammoth 8900 (R)
Mammoth 8900 (R)
Mammoth 8900 (R)
Mammoth 8900 (RW)
Mammoth 8900 (RW with upgrade)
Mammoth 8900 (RW)
AIT
15m
50m
170m


230m


170m
230m

See note
1.75GB
7.0GB
25.0GB
25.0GB
35.0GB
35.0GB
36.0GB
50.0GB
Drive
AIT Drive (300/300C)
AIT Drive (300/300C)
AIT Drive (300/300C)
AIT2 Drive (500C)
AIT Drive (300/300C)
AIT2 Drive (500C)
AIT2 Drive (500C)
AIT2 Drive (500C)
AITC
15m
50m
170m


230m


170m
230m

See note
3.5 GB
14.0 GB
50.0 GB
50.0 GB
70.0 GB
70.0 GB
72.0 GB
100.0 GB
Drive
AIT Drive (300/300C)
AIT Drive (300/300C)
AIT Drive (300/300C)
AIT2 Drive (500C)
AIT Drive (300/300C)
AIT2 Drive (500C)
AIT2 Drive (500C)
AIT2 Drive (500C)
M2
22m
48m
75m
125m
150m
170m
225m
See note
5.0GB
12.0GB
20.0GB
30.0GB
40.0GB
45.0GB
60.0GB
Drive (Read Write)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
M2C
22m
48m
75m
125m
150m
170m
225m
See note
12.0GB
30.0GB
50.0GB
75.0GB
100.0GB
113.0GB
150.0GB
Drive (Read Write)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Mammoth II (RW)
Note:
The actual capacities may vary depending on which cartridges and drives are used.
  • For the AITC format, the normal compression ratio is 2:1.
  • For the M2C format, the normal compression ratio is 2.5:1.

ESTCAPacity
Specifies the estimated capacity for the volumes 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.

Specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes).

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 8mm tapes, see Table 55.

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

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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.

For EXTERNAL library types (that is, a library 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

Examples

Task

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

DEFINE DEVCLASS -- DLT

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--DLT-------------------->
 
   .-FORMAT--=--DRIVE------.
>--+-----------------------+--+----------------------+---------->
   '-FORMAT--=--+-DRIVE--+-'  '-ESTCAPacity--=--size-'
                +-DLT10--+
                +-DLT10C-+
                +-DLT15--+
                +-DLT15C-+
                +-DLT20--+
                +-DLT20C-+
                +-DLT35--+
                +-DLT35C-+
                +-DLT40--+
                +-DLT40C-+
                +-SDLT---+
                '-SDLTC--'
 
   .-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.
Note:
For ACSLS upgrades from Enhanced Version 2 to Version 3, you must define the device class with a DEVTYPE parameter of DLT.

FORMAT
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 table lists the recording formats and estimated capacities for DLT devices:

Table 56. 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 containing some drives that support recording formats superior to other drives.

DLT10 10.0GB Uncompressed format, using only CompacTape III cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT10C

See note (CDL).

20.0GB

Compressed format, using only CompacTape III cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT15 15.0GB Uncompressed format, using only CompacTape IIIxt cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT15C

See note (CDL).

30.0GB

Compressed format, using only CompacTape IIIxt cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT20 20.0GB Uncompressed format, using only CompacTape IV cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT20C

See note (CDL).

40.0GB

Compressed format, using only CompacTape IV cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT35 35.0GB Uncompressed format, using only CompacTape IV cartridges

Valid with DLT7000 and DLT8000 drives

DLT35C

See note (CDL).

70.0GB

Compressed format, using only CompacTape IV cartridges

Valid with DLT7000 and DLT8000 drives

DLT40 40.0GB Uncompressed format, using CompacTape IV cartridges

Valid with a DLT8000 drive

DLT40C

See note (CDL).

80.0GB

Compressed format, using CompacTape IV cartridges

Valid with a DLT8000 drive

SDLT

See note (BRC).

100.0GB Uncompressed format, using Super DLT Tape 1 cartridges

Valid with a Super DLT drive

SDLTC

See note (BRC).

See note (CDL).

200.0GB

Compressed format, using Super DLT Tape 1 cartridges

Valid with a Super DLT drive

Notes:

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

  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 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 K (Kilobytes), M (Megabytes), or G (Gigabytes).

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 estimated capacities, see Table 56.

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

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

number
Specifies the maximum number of drives 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.

DEFINE DEVCLASS -- DTF

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--DTF-------------------->
 
>--FORMAT--=--+-DRIVE-+--+----------------------+--------------->
              +-DTF---+  '-ESTCAPacity--=--size-'
              +-DTFC--+
              +-DTF2--+
              '-DTF2C-'
 
   .-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 DTF tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=DTF (Required)
Specifies that the DTF tape devices are assigned to this device class.

FORMAT
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 table lists the recording formats and estimated capacities for DTF devices:

Table 57. Recording Format and Default Estimated Capacity for DTF

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 containing some drives that support recording formats superior to other drives.

DTF 12.0GB
42.0GB
Using GW-240 tape cassettes
Using GW-730L tape cassettes
DTFC 24.0GB
84.0GB
Using GW-240 tape cassettes
Using GW-730L tape cassettes
DTF2 60.0GB
200.0GB
Using GW2-60GS tape cassettes
Using GW2-200GL tape cassettes
DTF2C 120.0GB
400.0GB
Using GW2-60GS tape cassettes
Using GW2-200GL tape cassettes

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For more information on estimated capacities, see Table 57.

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

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- ECARTRIDGE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--ECARTridge------------->
 
   .-FORMAT--=--DRIVE------.
>--+-----------------------+--+----------------------+---------->
   '-FORMAT--=--+-DRIVE--+-'  '-ESTCAPacity--=--size-'
                +-18T----+
                +-18TC---+
                +-36T----+
                +-36TC---+
                +-SD3A---+
                +-SD3AC--+
                +-SD3B---+
                +-SD3BC--+
                +-SD3C---+
                +-SD3CC--+
                +-9840---+
                +-9840C--+
                +-9940---+
                +-9940C--+
                +-M8100--+
                '-M8100C-'
 
   .-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 ECARTRIDGE tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=ECARTridge (Required)
Specifies that the ECARTRIDGE device type is assigned to the device class. ECARTRIDGE indicates that a specific type of cartridge tape device (STK) is assigned to this device class.
Note:
For ACSLS upgrades from Enhanced Version 2 to Version 3, you must define the device class with a DEVTYPE parameter of ECARTRIDGE.

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

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

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

Table 58. Recording Formats and Default Estimated Capacities for ECARTRIDGE Tapes

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 containing some drives that support recording formats superior to other drives.

18T 360MB 18-track uncompressed (standard) (read-only) format
18TC

See note

1.44GB

18-track extended (read-only), compressed format
36T 720MB 36-track extended (read and write) format
36TC

See note

2.88GB

36-track extended (read and write), compressed format
SD3A 10GB Uncompressed (standard) format, using a 10GB 'A' cartridge with 91 meters (298 feet) of tape
SD3AC

See note

40GB

Compressed format, using a 10GB 'A' cartridge with 91 meters (298 feet) of tape
SD3B 25GB Uncompressed (standard) format, using a 25GB 'B' cartridge with 204 meters (668 feet) of tape
SD3BC

See note

100GB

Compressed format, using a 25GB 'B' cartridge with 204 meters (668 feet) of tape
SD3C 50GB Uncompressed (standard) format, using a 50GB 'C' cartridge with 392 meters (1286 feet) of tape
SD3CC

See note

200GB

Compressed format, using a 50GB 'C' cartridge with 392 meters (1286 feet) of tape
9840 20GB Uncompressed (standard) format, using a 20GB cartridge with 270 meters (885 feet) of tape
9840C

See note

80GB

LZ-1 Enhanced (4:1) compressed format, using a 80GB cartridge with 270 meters (885 feet) of tape
9940 60GB Uncompressed (standard) format, using a 60GB cartridge.
9940C

See note

120GB

Compressed format, using a 60GB cartridge.
M8100 10GB Uncompressed (standard) format, using a 10GB cartridge.
M8100C 10GB Compressed format, using a 10GB cartridge. Because there is no mechanism to determine the type of cartridge in an M8100 drive, the server assumes a 10GB estimated uncompressed capacity.
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.

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

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

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.

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:

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- FILE

Use the FILE device class when you are using files on magnetic disk storage as volumes that store data sequentially (as on tape). The FILE device class does not support EXTERNAL or RSM libraries.

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--DEVType--=--FILE--------->
 
   .-MOUNTLimit--=--1------.  .-MAXCAPacity--=--4M---.
>--+-----------------------+--+----------------------+---------->
   '-MOUNTLimit--=--number-'  '-MAXCAPacity--=--size-'
 
   .-DIRectory--=--current_directory_name-.
>--+--------------------------------------+--------------------->
   '-DIRectory--=--directory_name---------'
 
   .-SHAREd--=--No------.
>--+--------------------+--------------------------------------><
   '-SHAREd--=--+-No--+-'
                '-Yes-'
 
 

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.

DEVType=FILE (Required)
Specifies that the FILE device type is assigned to the device class. FILE indicates that a file is 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
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 a number from 1 to 256. If the device class will be shared with a storage agent (by specifying the SHARED=YES parameter), drives will be defined or deleted to match the mountlimit value.

MAXCAPacity
Specifies the maximum size of any data storage files defined to a storage pool in this device class. The default value is 4MB (MAXCAPACITY=4M). MAXCAPACITY=5M specifies that the maximum capacity for a volume in this device class is 5 megabytes. This parameter is optional.

4M
Specify that the maximum capacity of the storage files is 4M (4MB).

size
Specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). The minimum value allowed is 100KB (MAXCAPACITY=100K).

The maximum value is 128GB (MAXCAPACITY=128G).

DIRectory
Specifies the directory location of the files used in this device class. Enclose the directory name in quotation marks if it contains embedded blanks, equal signs, or other special characters. 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 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.

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, if you define a device class with a DIRECTORY of c:\smstor and the server needs a scratch volume in this device class to store export data, the file that the server creates may be named c:\smstor\00566497.exp.

SHAREd
Specifies that this FILE devclass will be shared between the server and one or more storage agents. To prepare for sharing, a library will be automatically defined along with a number of drives corresponding to the MOUNTLIMIT parameter value. The drive names are the the name of the library plus a number from 1 to the mount limit number. For example, if the library name is FILE and the mount limit is set to 4, the drives are named FILE11, FILE12, FILE13, FILE14.
Note:
Tivoli SANergy version 2.2 is a prerequisite for storage to be shared by the server and storage agent. Tivoli SANergy must be installed and configured before you define the device class.

Examples

Task

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

DEFINE DEVCLASS -- GENERICTAPE

When using this device type, the server does not recognize either the type of device or the cartridge recording format. Because 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.

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--GENERICTAPE------------>
 
                             .-MOUNTRetention--=--60------.
>--+----------------------+--+----------------------------+----->
   '-ESTCAPacity--=--size-'  '-MOUNTRetention--=--minutes-'
 
   .-MOUNTWait--=--60------.  .-MOUNTLimit--=--DRIVES-----.
>--+-----------------------+--+---------------------------+----><
   '-MOUNTWait--=--minutes-'  '-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 tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=GENERICTAPE (Required)
Specifies that the GENERICTAPE device type is assigned to the device class. GENERICTAPE indicates that the volumes for this device class are used in tape drives supported by the operating system's 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.

ESTCAPacity
Specifies the estimated capacity for the volumes 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.

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

You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

MOUNTRetention
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 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, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- LTO

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--LTO-------------------->
 
   .-FORMAT--=--DRIVE--------.
>--+-------------------------+--+----------------------+-------->
   '-FORMAT--=--+-DRIVE----+-'  '-ESTCAPacity--=--size-'
                +-ULTRIUM--+
                '-ULTRIUMC-'
 
   .-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 LTO tape drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=LTO (Required)
Specifies that the linear tape open (LTO) device type is assigned to the device class.

FORMAT
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 table lists the recording formats and estimated capacities for LTO devices:

Table 59. Recording Format and Default Estimated Capacity for LTO

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 containing some drives that support recording formats superior to other drives.

ULTRIUM 100.0GB Uncompressed format, using Ultrium cartridges
ULTRIUMC

See note

200.0GB

Compressed format, using Ultrium cartridges
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.

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes).

For example, ESTCAPACITY=100G specifies that the estimated capacity for a volume in this device class is 100 gigabytes.

For more information on estimated capacities, see Table 59.

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

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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, you can enhance device sharing between applications by settting this parameter to a low value (for example, two minutes).

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives 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.

Examples

Task

Define a device class named LTOTAPE for an LTO drive in a library named LTOLIB. The format is ULTRIUMC, mount limit is DRIVES, mount retention is 5, tape volume prefix is named SMVOL, and the estimated capacity is 200GB.

Command:
define devclass ltotape devtype=lto library=ltolib 
format=ultriumc mountlimit=drives mountretention=5 
prefix=smvol estcapacity=200G

DEFINE DEVCLASS -- NAS

Use the Network Attached Storage (NAS) device class when you are using network-attached storage (NAS) file servers in conjunction with Tivoli Data Protection for NDMP (Network Data Management Protocol). The NAS device class does not support EXTERNAL or RSM libraries.

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--DEVType--=--NAS---------->
 
>--LIBRary--=--library_name--MOUNTRetention--=--0--------------->
 
   .-MOUNTWait--=--60------.  .-MOUNTLimit--=--DRIVES-----.
>--+-----------------------+--+---------------------------+----->
   '-MOUNTWait--=--minutes-'  '-MOUNTLimit--=--+-DRIVES-+-'
                                               +-number-+
                                               '-0------'
 
>--ESTCAPacity--=--size----------------------------------------->
 
   .-PREFIX--=--ADSM-------------------.
>--+-----------------------------------+-----------------------><
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
 

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.

DEVType=NAS (Required)
Specifies that the network-attached storage (NAS) device type is assigned to the device class. The NAS device type is for drives attached to and used by a NAS file server for backup of NAS file systems.

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

MOUNTRetention=0 (Required)
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. Zero (0) is the only supported value for device classes with DEVType=NAS.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
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.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives 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.

ESTCAPacity (Required)
Specifies the estimated capacity for the volumes assigned to this device class.

You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes).

For example, ESTCAPACITY=100G specifies that the estimated capacity for a volume in this device class is 100 gigabytes.

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

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

Examples

Task

Define a device class named NASTAPE for a NAS drive in a library named NASLIB. The mount limit is DRIVES, mount retention is 0, tape volume prefix is named SMVOL, and the estimated capacity is 200GB.

Command:
define devclass nastape devtype=nas library=naslib 
mountretention=0 mountlimit=drives  
prefix=smvol estcapacity=200G

DEFINE DEVCLASS -- OPTICAL and WORM TYPES

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--+-OPTical-----+-------->
                                         +-WORM--------+
                                         |        (1)  |
                                         +-WORM12------+
                                         |        (1)  |
                                         '-WORM14------'
 
   .-FORMAT--=--DRIVE------------.
>--+-----------------------------+--+----------------------+---->
   '-FORMAT--=--+-DRIVE--------+-'  '-ESTCAPacity--=--size-'
                |       (2)    |
                +-650MB--------+
                |        (2)   |
                +-1300MB-------+
                |        (2)   |
                +-2600MB-------+
                |        (2)   |
                +-5200MB-------+
                |        (3)   |
                +-5600MB-------+
                |        (4)   |
                +-6800MB-------+
                |        (2)   |
                +-9100MB-------+
                |         (4)  |
                +-10200MB------+
                |         (3)  |
                +-12000MB------+
                |         (4)  |
                '-14800MB------'
 
   .-MOUNTRetention--=--60------.  .-MOUNTWait--=--60------.
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
   .-MOUNTLimit--=--DRIVES-----.
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Notes:

  1. The WORM12 or WORM14 device type is only valid on AIX 4.1.4 or subsequent systems.

  2. This value not valid for WORM12 or 14 device types.

  3. This value is only valid for WORM12 device types.

  4. This value is only valid for WORM14 device types.

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 optical drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType (Required)
Specifies that the OPTICAL and WORM, WORM12, WORM14 device types are assigned to the device class.

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 one-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
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 table lists the recording formats and estimated capacities for OPTICAL and WORM devices:

Table 60. Estimated Capacities for OPTICAL and WORM Drives

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 containing some drives that support recording formats superior to other drives.

650MB 650MB Using a 650 MB 5.25-inch optical drive

Not valid for WORM12 or 14 device types

1300MB 1300MB Using a 1300 MB 5.25-inch optical drive

Not valid for WORM12 or 14 device types

2600MB 2600MB Using a 2600 MB 5.25-inch optical drive

Not valid for WORM12 or 14 device types

5200MB 5200MB Using a 5200 MB 5.25-inch optical drive

Not valid for WORM12 or 14 device types

5600MB 5600MB Using a 5600 MB 12-inch optical drive

Only valid for WORM12 device types

6800MB 6800MB Using a 6800 MB 14-inch optical drive

Only valid for WORM14 device types

9100MB 9100MB Using a 9100 MB 5.25-inch optical drive

Not valid for WORM12 or 14 device types

10200MB 10200MB Using a 10200 MB 14-inch optical drive

Only valid for WORM14 device types

12000MB 12000MB Using a 12000 MB 12-inch optical drive

Only valid for WORM12 device types

14800MB 14800MB Using a 14800 MB 14-inch optical drive

Only valid for WORM14 device types

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

For more information on estimated capacities, see Table 60.

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true mount limit value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool. Any current transaction will continue and complete but new transactions will be terminated.

DEFINE DEVCLASS -- QIC

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--QIC-------------------->
 
   .-FORMAT--=--DRIVE--------.
>--+-------------------------+--+----------------------+-------->
   '-FORMAT--=--+-DRIVE----+-'  '-ESTCAPacity--=--size-'
                +-QIC120---+
                +-QIC150---+
                +-QIC525---+
                +-QIC1000--+
                +-QIC2GB---+
                +-QIC2GBC--+
                +-QIC4GB---+
                +-QIC4GBC--+
                +-QIC12GB--+
                +-QIC12GBC-+
                +-QIC20GB--+
                +-QIC20GBC-+
                +-QIC30GB--+
                +-QIC30GBC-+
                +-QIC5010--+
                +-QIC5010C-+
                +-QIC25GB--+
                +-QIC25GBC-+
                +-QIC50GB--+
                '-QIC50GBC-'
 
   .-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 tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=QIC (Required)
Specifies that the quarter-inch cartridge (QIC) device type is assigned to the device class.

FORMAT
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 tables list the recording formats, estimated capacities and recording format options for QIC devices:

Table 61. Recording Format and Default Estimated Capacity for Quarter-inch Cartridge (QIC) Tape

Format Estimated Capacity Description
DRIVE - The server selects the highest format that can be supported by the sequential access drive on which a volume is mounted.

Avoid specifying the DRIVE value when a mixture of devices is used within the same library.

For example, do not use this option for a library containing some drives that support recording formats superior to other drives.

QIC120 26.0MB - 172.0MB 120 QIC format, depending on media

Using DC600XTD, DC6150, DC6320, and DC6525

QIC150 31.0MB - 207.0MB 150 QIC format, depending on media

Using DC600XTD, DC6150, DC6320, and DC6525

QIC525 65.0MB - 427.0MB 525 QIC format, depending on media

Using DC6320 and DC6525

QIC1000 169.0MB - 1.1GB 1000 QIC format, depending on media

Using DC9100 and DC9120XL

QIC2GB 2.0GB Uncompressed 2000 QIC format

Using DC9100 and DC9120XL

QIC2GBC

See note

4.0GB

Compressed 2000 QIC format
QIC4GB 4.0GB Uncompressed 4000 QIC format
QIC4GBC

See note

8.0GB

Compressed 4000 QIC format
QIC12GB 12.0GB Uncompressed 12000 QIC format, using 343-meter tape
QIC12GBC

See note

24.0GB

Compressed 12000 QIC format, using 343-meter tape
QIC5010 13.0GB - 16.0GB Uncompressed 5010 QIC format, depending on media
QIC5010C

See note

26.0GB - 32.0GB

Compressed 5010 QICformat, depending on media
QIC20GB 20.0GB Uncompressed 20000 QIC format
QIC20GBC

See note

40.0GB

Compressed 20000 QIC format
QIC25GB 25.0GB Uncompressed 25000 QIC format
QIC25GBC

See note

50.0GB

Compressed 25000 QIC format
QIC30GB 30.0GB Uncompressed 30000 QIC format
QIC30GBC

See note

60.0GB

Compressed 30000 QIC format
QIC50GB 50.0GB Uncompressed 50GB QIC format
QIC50GBC

See note

100.0GB

Compressed 50GBC QIC format
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.

Table 62. QIC Tape Recording Format Options

Tape\Format
QIC-120
QIC-150
QIC-525
QIC-1000
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
Note:
The server cannot use 3M DC300XLP and 3M DC600A tapes.

ESTCAPacity
Specifies the estimated capacity for the volumes 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 K (Kilobytes), M (Megabytes), or G (Gigabytes). The smallest value allowed is 100KB (that is, ESTCAPACITY=100K).

For example, ESTCAPACITY=5M specifies that the estimated capacity for a volume in this device class is 5 megabytes.

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

PREFIX
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, 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 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:

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

MOUNTRetention
Specifies the number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. 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 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 to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
Note:
For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives used concurrently in this device class by the server. 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 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- REMOVABLEFILE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
>--LIBRary--=--library_name--DEVType--=--REMOVABLEfile---------->
 
   .-MAXCAPacity--=--space_remaining-.
>--+---------------------------------+-------------------------->
   '-MAXCAPacity--=--size------------'
 
   .-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 removable media drives used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

DEVType=REMOVABLEfile (Required)
Specifies that the REMOVABLEFILE device type is assigned to the device class. REMOVABLEFILE indicates that the volumes for this device class are files on local, removable media. Common drives for this device type include Iomega Zip and Jaz drives, and SyQuest drives. To access volumes that belong to this device class, the server requests that the removable media be mounted in drives. The server then opens a file on the media and reads or writes file data. Removable file drives are treated as single sided. Two-sided media are treated as two separate volumes.

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 REMOVABLEFILE are sequential access volumes.

When using CD-ROM media for the REMOVABLEFILE device type, the library type must be specified as MANUAL. Access this media through a drive letter, for example, E:. Use the device manufacturer's utilities to format and label the media.

The label on the media must meet the following restrictions:

MAXCAPacity
Specifies the maximum size of any volumes defined to a storage pool categorized by this device class. This parameter is optional.

Because the server opens only one file per physical removable medium, specify a capacity such that the one file makes full use of your media capacity.

space_remaining
The default maximum capacity is the space remaining on the media after it is first used.

size
You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes).

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

MOUNTRetention
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 a number from 0 to 9999.

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

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual or 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 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. The default is DRIVES. You can specify a number from 0 to 256.
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.

The following are possible values:

DRIVES
Specifies that every time a mount point is allocated, the number of drives defined to the library is used to calculate the true value (including online status).

number
Specifies the maximum number of drives 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.

DEFINE DEVCLASS -- SERVER

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--DEVType--=--SERVER------->
 
                               .-MAXCAPacity--=--500M-.
>--SERVERName--=--server_name--+----------------------+--------->
                               '-MAXCAPacity--=--size-'
 
   .-MOUNTLimit--=--1------.  .-MOUNTRetention--=--60------.
>--+-----------------------+--+----------------------------+---->
   '-MOUNTLimit--=--number-'  '-MOUNTRetention--=--minutes-'
 
   .-PREFIX--=--ADSM--------------.
>--+------------------------------+----------------------------->
   '-PREFIX--=--+-ADSM----------+-'
                '-volume_prefix-'
 
   .-RETRYPeriod--=--10--------------------.
>--+---------------------------------------+-------------------->
   '-RETRYPeriod--=--retry_value_(minutes)-'
 
   .-RETRYInterval--=--30--------------------.
>--+-----------------------------------------+-----------------><
   '-RETRYInterval--=--retry_value_(seconds)-'
 
 

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.

DEVType=SERVER (Required)
Specifies a remote connection that supports virtual volumes.

SERVERName (Required)
Specifies the name of the server. The SERVERNAME parameter must match a defined server.

MAXCAPacity
Specifies the maximum size for objects created on the target server; the default for this value is 500M. This parameter is optional.

500M
Specifies that the maximum capacity is 500M (500MB).

size
Specify this value as an integer followed by K (Kilobytes), M (Megabytes), or G (Gigabytes). The minimum value allowed is 100KB (MAXCAPACITY=100K).

MOUNTLimit
Specifies the maximum number of simultaneous sessions between the source server and the target server. Any attempts to access more sessions than indicated by the mount limit cause the requester to wait. This parameter is optional. The default value is 1. You can specify a number from 1 to 256.

The following are possible values:

1
Specifies that only one session between the source server and the target server is allowed.

number
Specifies the number of simultaneous sessions between the source server and the target server.

MOUNTRetention
Specifies the number of 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 a number from 0 to 9999.

PREFIX
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:

An example of a high level archive file name using the default prefix is ADSM.volume1.

RETRYPeriod
Specifies the retry period in minutes. The retry period is the interval during which the server attempts to contact a target server if there is a suspected communications failure. This parameter is optional. The default value is 10 minutes.

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

Related Commands


Table 63. Commands Related to DEFINE DEVCLASS

Command Description
BACKUP DEVCONFIG Backs up Tivoli Storage Manager 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 device classes.
UPDATE DEVCLASS Changes the attributes of a device class.


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