Tivoli Header

Administrator's Reference


UPDATE DEVCLASS (Update the Attributes of a Device Class)

Use this command to update a defined device class.

Note:
The DISK device class is predefined by Tivoli Storage Manager and cannot be modified with the UPDATE 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:

UPDATE DEVCLASS -- 3570

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE-+-'
                                              +-3570B-+
                                              '-3570C-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined.

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

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

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

Table 303. 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 categorized by this device class. This parameter is optional.

You can specify this parameter if the default estimated capacity for the device class is inaccurate due to compression of data.

You must specify this value as an integer followed by K (Kilobytes), M (Megabytes), 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.

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

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

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

If you have already established a media label naming convention that supports your current management system, consider using 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. 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

UPDATE DEVCLASS -- 3590

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+------------------------+----->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE---+-'
                                              +-3590B---+
                                              +-3590C---+
                                              +-3590E-B-+
                                              '-3590E-C-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined.

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

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

The following tables list the recording formats, estimated capacities and recording format options for 3590 devices:

Table 304. 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 305. 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 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 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 maximum length of this prefix is 8 characters.

If you have already established a media label naming convention that supports your current management system, consider using 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. 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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. Any current transaction will continue and complete, but new transactions will be terminated.

UPDATE DEVCLASS -- 4MM

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE-+-'
                                              +-DDS1--+
                                              +-DDS1C-+
                                              +-DDS2--+
                                              +-DDS2C-+
                                              +-DDS3--+
                                              +-DDS3C-+
                                              +-DDS4--+
                                              '-DDS4C-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+-----------------------+--+----------------------------+---->
   '-MOUNTWait--=--minutes-'  '-MOUNTRetention--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined.

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

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

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

Table 306. 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 1.3GB (60-meter)

2.0GB (90-meter)

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

See note

1.3GB (60-meter)

2.0GB (90-meter)

Compressed format, applies only 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 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 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 306.

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

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 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.

UPDATE DEVCLASS -- 8MM

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE-+-'
                                              +-8200--+
                                              +-8200C-+
                                              +-8500--+
                                              +-8500C-+
                                              +-8900--+
                                              +-AIT---+
                                              +-AITC--+
                                              +-M2----+
                                              '-M2C---'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

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

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

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

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

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.

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



2.35GB



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



4.7GB



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
AIT 15m
AIT 50m
AIT 170m


AIT 230m


AIT2 170m
AIT2 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
AIT 15m
AIT 50m
AIT 170m


AIT 230m


AIT2 170m
AIT2 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 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 the default estimated capacity for 8mm tapes, see Table 307.

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

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

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

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

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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

Examples

Task

Update a device class named 8MMTAPE. Change the mount limit to 3 and the estimated capacity to 10GB.

Command:
update devclass 8mmtape mountlimit=3 estcapacity=10G

Task

Update an 8mm device class named 8MMTAPE to a 15-minute mount retention.

Command:
update devclass 8mmtape mountretention=15

UPDATE DEVCLASS -- CARTRIDGE

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+-----------------------+------>
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE--+-'
                                              +-3480---+
                                              +-3480XF-+
                                              +-3490B--+
                                              '-3490C--'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

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

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

The following table lists the recording formats and estimated capacities for Cartridge System Tapes (CST):

Table 308. Recording Format and Default Estimated Capacity for Cartridge Tape Volumes

Format Estimated Capacity Description
DRIVE -- Specifies that the server 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, do not use this option for a library containing some drives that support recording formats superior to other drives.

3480 180MB 18-track basic recording format (CST)
3480XF 180MB 18-track compressed recording format (CST)
3490B See note
360MB
720MB
36-track
Uncompressed (basic) recording format (CST)
Compressed recording format (ECCST)
3490C See note
360MB
720MB
36-track
Uncompressed (basic) recording format (CST)
Compressed recording format (ECCST)
Note:
The actual capacities may vary depending on which cartridges and drives are used.

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

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.

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

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

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

However, for EXTERNAL library types, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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 gain access to the storage pool. Any current transaction will continue and complete but new transactions will be terminated.

Examples

Task

Update a device class named SQUARE1 with RACF protection active for all tape volumes assigned to this device class. All data is compressed for this device class.

Command:
update devclass square1 compression=Yes protection=yes

Task

Update the amount of time to retain idle mounted volumes for the ROUND1 device class to 75 minutes.

Command:
update devclass round1 mountretention=75

Task

Update the STOR1 device class to have RACF(R) protection and a maximum mount limit of 1.

Command:
update devclass stor1 mountlimit=1 PROtection=Yes

UPDATE DEVCLASS -- DLT

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+-----------------------+------>
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE--+-'
                                              +-DLT10--+
                                              +-DLT10C-+
                                              +-DLT15--+
                                              +-DLT15C-+
                                              +-DLT20--+
                                              +-DLT20C-+
                                              +-DLT35--+
                                              +-DLT35C-+
                                              +-DLT40--+
                                              +-DLT40C-+
                                              +-SDLT---+
                                              '-SDLTC--'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

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

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

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

Table 309. 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 or CompacTape IV cartridges
DLT10C

See note (CDLU).

20.0GB

Compressed format, using only CompacTape III and CompacTape IV cartridges
DLT15 15.0GB Uncompressed format, using only CompacTape IIIxt or CompacTape IV cartridges (not CompacTape III)
Note:
Valid with DLT2000XT, DLT4000, and DLT7000 drives
DLT15C

See note (CDLU).

30.0GB

Compressed format, using only CompacTape IIIxt or CompacTape IV cartridges (not CompacTape III)

Valid with DLT2000XT, DLT4000, and DLT7000 drives

DLT20 20.0GB Uncompressed format, using only CompacTape IV cartridges

Valid with DLT4000, DLT7000, and DLT8000 drives

DLT20C

See note (CDLU).

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 (CDLU).

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 (CDLU).

80.0GB

Compressed format, using CompacTape IV cartridges

Valid with a DLT8000 drive

SDLT

See note (BRCU).

100.0GB Uncompressed format, using Super DLT Tape 1 cartridges

Valid with a Super DLT drive

SDLTC

See note (BRCU).

See note (CDLU).

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

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

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

UPDATE DEVCLASS -- DTF

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE-+-'
                                              +-DTF---+
                                              +-DTFC--+
                                              +-DTF2--+
                                              '-DTF2C-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined. The maximum length of the device class name is 30 characters.

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

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

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

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

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

For more information on estimated capacities, see Table 310.

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

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

UPDATE DEVCLASS -- ECARTRIDGE

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+-----------------------+------>
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE--+-'
                                              +-18T----+
                                              +-18TC---+
                                              +-36T----+
                                              +-36TC---+
                                              +-SD3A---+
                                              +-SD3AC--+
                                              +-SD3B---+
                                              +-SD3BC--+
                                              +-SD3C---+
                                              +-SD3CC--+
                                              +-9840---+
                                              +-9840C--+
                                              +-9940---+
                                              +-9940C--+
                                              +-M8100--+
                                              '-M8100C-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

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

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

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

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.

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

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

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+-----------------------+--+----------------------+---------->
   '-MOUNTLimit--=--number-'  '-MAXCAPacity--=--size-'
 
>--+------------------------------+--+--------------------+----><
   '-DIRectory--=--directory_name-'  '-SHAREd--=--+-No--+-'
                                                  '-Yes-'
 
 

Parameters

device_class_name(Required)
Specifies the name of the device class to be updated.

MOUNTLimit
Specifies the maximum number of files that can be simultaneously open for input/output. This parameter is optional. You can specify a number from 1 to 256.

MAXCAPacity
Specifies the maximum size of any data storage files categorized by this device class. This parameter is optional.

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 64GB (MAXCAPACITY=64G).

Do not define a MAXCAPACITY value greater than 640M when this file is for REMOVABLEFILE CD-ROM support. A value less than a CD-ROM's usable space (650MB) allows for a one-to-one match between files from the FILE device class and copies that are on CD-ROM.

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

DIRectory
Specifies the directory location of the file used in this device class. This parameter is optional.

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, if you define a device class with a DIRECTORY of /TSMSTOR and the server needs a scratch volume in this device class to store export data, the file that the server creates may be named /TSMSTOR/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 associated with the device class. If the library and drives already exist and the MOUNTLimit is changed, drives will either be created to reach a new higher MOUNTLimit value or deleted to reach a new lower value.

Examples

Task

Prepare a FILE device class (named PLAINFILES) for sharing with a Tivoli Storage Manager storage agent.

Command:
update  devclass plainfiles shared=yes  

Task

Update a file device class named STORFILES to a maximum capacity of 25MB.

Command:
update devclass storfiles maxcap=25m

UPDATE DEVCLASS -- GENERICTAPE

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-ESTCAPacity--=--size-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

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

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 number of minutes to retain an idle sequential access volume before dismounting it. This parameter is optional. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types, 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 mountlimit 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.

UPDATE DEVCLASS -- LTO

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+-------------------------+---->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE----+-'
                                              +-ULTRIUM--+
                                              '-ULTRIUMC-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated. The maximum length of the device class name is 30 characters.

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

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

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

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

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

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, for a library managed by an external media management program), 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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.

Examples

Task

Update a device class named LTOTAPE. Change the mount limit to 2.

Command:
update devclass ltotape mountlimit=2

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

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+----------------------+------->
   '-LIBRary--=--library_name-'  '-MOUNTRetention--=--0-'
 
>--+-----------------------+--+---------------------------+----->
   '-MOUNTWait--=--minutes-'  '-MOUNTLimit--=--+-DRIVES-+-'
                                               +-number-+
                                               '-0------'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-------------------------------+---------------------------><
   '-PREFIX--=--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.

LIBRary
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
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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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
Specifies the estimated capacity for the volumes assigned to this device class. This parameter is optional.

This value must be 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 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.

Examples

Task

Update a device class named NASTAPE. Change the estimated capacity to 200GB.

Command:
update devclass nastape library=naslib estcapacity=200G

UPDATE DEVCLASS -- OPTICAL and WORM TYPES

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--------------------------------->
   '-LIBRary--=--library_name-'
 
>--+-----------------------------+--+----------------------+---->
   '-FORMAT--=--+-DRIVE--------+-'  '-ESTCAPacity--=--size-'
                |       (1)    |
                +-650MB--------+
                |        (1)   |
                +-1300MB-------+
                |        (1)   |
                +-2600MB-------+
                |        (1)   |
                +-5200MB-------+
                |        (2)   |
                +-5600MB-------+
                |        (3)   |
                +-6800MB-------+
                |        (4)   |
                +-9100MB-------+
                |         (5)  |
                +-10200MB------+
                |         (2)  |
                +-12000MB------+
                |         (5)  |
                '-14800MB------'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Notes:

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

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

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

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

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

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined.

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

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

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

Table 313. 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 typesdevice 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 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 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 313.

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types, 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. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. You can specify a number from 0 to 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 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 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.

UPDATE DEVCLASS -- QIC

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--+-------------------------+---->
   '-LIBRary--=--library_name-'  '-FORMAT--=--+-DRIVE----+-'
                                              +-QIC120---+
                                              +-QIC150---+
                                              +-QIC525---+
                                              +-QIC1000--+
                                              +-QIC2GB---+
                                              +-QIC2GBC--+
                                              +-QIC4GB---+
                                              +-QIC4GBC--+
                                              +-QIC12GB--+
                                              +-QIC12GBC-+
                                              +-QIC20GB--+
                                              +-QIC20GBC-+
                                              +-QIC30GB--+
                                              +-QIC30GBC-+
                                              +-QIC5010--+
                                              +-QIC5010C-+
                                              +-QIC25GB--+
                                              +-QIC25GBC-+
                                              +-QIC50GB--+
                                              '-QIC50GBC-'
 
>--+----------------------+------------------------------------->
   '-ESTCAPacity--=--size-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be defined.

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

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

The following tables list the recording formats, estimated capacities and recording format options for QIC devices:

Table 314. 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, if you have drives that support recording formats superior to other drives in a library, do not specify the FORMAT=DRIVE option.

QIC120 26.0MB - 172.0MB 120 QIC format, depending on media
QIC150 31.0MB - 207.0MB 150 QIC format, depending on media
QIC525 65.0MB - 427.0MB 525 QIC format, depending on media
QIC1000 169.0MB - 1.1GB 1000 QIC format, depending on media
QIC2GB 2.0GB Uncompressed 2000 QIC format
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 315. 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 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 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 314.

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

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

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library 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. 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 mountlimit 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.

UPDATE DEVCLASS -- REMOVABLEFILE

Privilege Class

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

Syntax

>>-UPDate DEVclass--device_class_name--------------------------->
 
>--+--------------------------+--------------------------------->
   '-LIBRary--=--library_name-'
 
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-DRIVES-+-'
                    +-number-+
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

LIBRary
Specifies the name of the defined library object that contains the removable media drives used by this device class. This parameter is optional. For information about defining a library object, see the DEFINE LIBRARY command.

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

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

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. You can specify a number from 0 to 9999.

UPDATE DEVCLASS -- SERVER

Privilege Class

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

Syntax

>>-UPDdate DEVclass--device_class_name-------------------------->
 
>--+----------------------------+--+----------------------+----->
   '-SERVERName--=--server_name-'  '-MAXCAPacity--=--500M-'
 
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'
                '-tape_volume_prefix-'
 
>--+-----------------------------+------------------------------>
   '-RETRYPeriod--=----minutes---'
 
>--+-------------------------------+---------------------------->
   '-RETRYInterval--=----seconds---'
 
>--+----------------------------+------------------------------->
   '-MOUNTRetention--=--minutes-'
 
>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-number-+-'
                    '-0------'
 
 

Parameters

device_class_name (Required)
Specifies the name of the device class to be updated.

SERVERName
Specifies the name of the server. The SERVERNAME parameter must match a defined server.
Note:
If you change the SERVERNAME of an existing server to a new name, data on the volumes under the old SERVERNAME will no longer be accessible with this device class.

MAXCAPacity
Specifies the maximum size that objects can be when created on the target server. This parameter is optional.

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

PREFIX
Specifies the beginning portion of the high-level archive file name on the target server. This parameter is optional. 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.

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.

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.

MOUNTRetention
Specifies the number of minutes to retain an idle connection with the target server before closing the connection. This parameter is optional. You can specify a number from 0 to 9999.

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. You can specify a number from 0 to 256.

The following are possible values:

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

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.

Related Commands


Table 316. Commands Related to UPDATE DEVCLASS

Command Description
BACKUP DEVCONFIG Backs up Tivoli Storage Manager device information to a file.
DEFINE DEVCLASS Defines a device class.
DEFINE LIBRARY Defines an automated or manual library.
DELETE DEVCLASS Deletes a device class name.
QUERY DEVCLASS Displays information about device classes.


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