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 TSM 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--FILE

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

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 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. 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). The maximum value is 128GB.

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

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.

Examples

Task

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

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

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----------+--'
                   '-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. The maximum length of the device class name is 30 characters.

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; the default for this value is 500M. This parameter is optional.

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 default value is 500M (that is, MAXCAPACITY=500M). The smallest value allowed is 100KB (that is, 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. Values specified for this parameter must meet the following conditions:

An example of a high level archive file name using the default prefix, with a TSM qualifier added, 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.

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.

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

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.

The following are possible values:

number
Specifies the maximum number of drives used concurrently in this device class by TSM. 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--------------------------->
 
>-----+-----------------------+---+---------------------------+->
      '-FORMAT--=--+-DRIVE-+--'   '-LIBRary--=--library_name--'
                   +-DDS1--+
                   +-DDS1C-+
                   +-DDS2--+
                   +-DDS2C-+
                   +-DDS3--+
                   +-DDS3C-+
                   +-DDS4--+
                   '-DDS4C-'
 
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
>-----+------------------------+---+-----------------------+---->
      '-PREFIX--=--+-ADSM---+--'   '-ESTCAPacity--=--size--'
                   '-prefix-'
 
>-----+------------------------+-------------------------------->
      '-MOUNTWait--=--minutes--'
 
>-----+----------------------------+---------------------------><
      '-MOUNTLimit--=--+-DRIVES-+--'
                       +-number-+
                       '-0------'
 

Parameters

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

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

The following are the possible values for 4mm devices:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note:Avoid specifying the DRIVE value when a mixture of devices is used within the same library. For example, if you have drives that support recording formats superior to other drives in a library, do not specify the FORMAT=DRIVE option.

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

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

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

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

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

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

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

DDS4C
Specifies that TSM writes data using the DDS-4C recording format for 4mm tapes, with compression. This format results in a cartridge capacity of approximately 40GB on 150-meter tape. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 40GB. This format only applies to 150-meter tape.

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.

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.

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, TSM 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.

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


Table 286. TSM Default Estimated Capacity for 4mm Tape

Tape Format Estimated Capacity
DDS1 1.3 - 2.0GB
DDS1C 1.3 - 2.0GB (see note)
DDS2 4.0GB
DDS2C 8.0GB (see note)
DDS3 12.0GB
DDS3C 24.0GB (see note)
DDS4 20.0GB
DDS4C 40.0GB (see note)
Note:This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 taking into account whether each is online).

number
Specifies the maximum number of drives used concurrently in this device class by TSM. 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-------------------------->
 
>-----+-----------------------+---+---------------------------+->
      '-FORMAT--=--+-DRIVE-+--'   '-LIBRary--=--library_name--'
                   +-8200--+
                   +-8200C-+
                   +-8500--+
                   +-8500C-+
                   +-8900--+
                   +-890C0-+
                   +-AIT---+
                   '-AITC--'
 
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
>-----+------------------------+---+-----------------------+---->
      '-PREFIX--=--+-ADSM---+--'   '-ESTCAPacity--=--size--'
                   '-prefix-'
 
>-----+------------------------+-------------------------------->
      '-MOUNTWait--=--minutes--'
 
>-----+----------------------------+---------------------------><
      '-MOUNTLimit--=--+-DRIVES-+--'
                       +-number-+
                       '-0------'
 

Parameters

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

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

Possible values for 8MM devices are:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

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

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

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

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

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

8900C
Specifies that TSM writes data using the 8900 recording format. This results in a tape capacity of 10.0GB when using standard 112-meter tape cartridges.

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

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

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

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.

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, TSM 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.

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

You must specify this value as an integer followed by 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).


Table 287. TSM Default Estimated Capacity for 8mm Tape

Tape Format Estimated Capacity
8200 2.3GB
8200C 2.3GB (see note)
8500 5.0GB
8500C 5.0GB (see note)
8900 5.0GB
8900C 10.0GB
AIT 25.0GB
AITC 60.0GB (see note)
Note:This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 TSM. 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 -- DLT

Privilege Class

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

Syntax

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

Parameters

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

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

Possible values for DLT devices are:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

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

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

DLT15
Specifies that TSM writes data using the DLT15 recording format. This results in a tape capacity of approximately 15.0GB when using CompacTape III or CompacTape IV cartridges.
Note:DLT15 and DLT15C can only be used on CompacTape IIIxt or IV cartridges, not CompacTape III. DLT15 and DLT15C are only valid with DLT2000XT, DLT4000 and DLT7000.

DLT15C
Specifies that TSM writes data using the DLT15C recording format. This results in a tape capacity of approximately 15.0GB when using CompacTape III and CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature so the actual capacity may be greater than 15.0GB depending on the effectiveness of the compression feature.
Note:DLT15 and DLT15C can only be used on CompacTape IIIxt or IV cartridges, not CompacTape III. DLT15 and DLT15C are only valid with DLT2000XT, DLT4000 and DLT7000.

DLT20
Specifies that TSM writes data using the DLT20 recording format. This results in a tape capacity of approximately 20.0GB when using CompacTape IV cartridges.
Note:The DLT20 format can only be used with CompacTape IV cartridges in a DLT4000 and DLT7000 drive.

DLT20C
Specifies that TSM writes data using the DLT20C recording format. This results in a tape capacity of approximately 20.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater than 20.0GB depending on the effectiveness of the compression feature.
Note:The DLT20 format can only be used with CompacTape IV cartridges in a DLT4000 and DLT7000 drive.

DLT30
Specifies that TSM writes data using the DLT35 recording format. This results in a tape capacity of approximately 35.0GB when using CompacTape IV cartridges.
Note:DLT35 and DLT35C can only be used with CompacTape IV cartridges.

DLT30C
Specifies that TSM writes data using the DLT35C recording format. This results in a tape capacity of approximately 70.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature so the actual capacity of the cartridge may be greater than 70.0GB depending on the effectiveness of the compression feature.
Note:DLT35 and DLT35C can only be used with CompacTape IV cartridges.

DLT35
Specifies that TSM writes data using the DLT35 recording format. This results in a tape capacity of approximately 35.0GB when using CompacTape IV cartridges.
Note:DLT35 and DLT35C can only be used with CompacTape IV cartridges.

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

DLT40
Specifies that TSM writes data using the DLT40 recording format. This results in a tape capacity of approximately 40.0GB when using CompacTape IV cartridges.
Note:Use this format only with cartridges in a DLT8000 drive.

DLT40C
Specifies that TSM writes data using the DLT40C recording format. This results in a tape capacity of approximately 80.0GB when using CompacTape IV cartridges. This format, however, uses the tape drive's hardware compression feature, so the actual capacity of the cartridge may be greater 80.0GB, depending on the effectiveness of compression feature.
Note:Use this format only with cartridges in a DLT8000 drive.

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.

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.

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, TSM 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.

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

You must specify this value as an integer followed by 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).


Table 288. TSM Default Estimated Capacity for DLT

Tape Format Estimated Capacity
DLT10 10.0GB
DLT10C 10.0GB (see note)
DLT15 15.0GB
DLT15C 15.0GB (see note)
DLT20 20.0GB
DLT20C 20.0GB (see note)
DLT30 35.0GB
DLT30C 70.0GB (see note)
DLT35 35.0GB
DLT35C 70.0GB (see note)
DLT40 40.0GB
DLT40C 80.0GB (see note)
Note:This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 TSM. 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-------------------------->
 
>-----+--------------------------+------------------------------>
      '-FORMAT--=--+-DRIVE----+--'
                   +-QIC120---+
                   +-QIC150---+
                   +-QIC525---+
                   +-QIC1000--+
                   +-QIC2000C-+
                   +-QIC4GB---+
                   +-QIC4GBC--+
                   +-QIC12GB--+
                   +-QIC12GBC-+
                   +-QIC25GB--+
                   '-QIC25GBC-'
 
>-----+---------------------------+----------------------------->
      '-LIBRary--=--library_name--'
 
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
>-----+------------------------+---+-----------------------+---->
      '-PREFIX--=--+-ADSM---+--'   '-ESTCAPacity--=--size--'
                   '-prefix-'
 
>-----+------------------------+-------------------------------->
      '-MOUNTWait--=--minutes--'
 
>-----+----------------------------+---------------------------><
      '-MOUNTLimit--=--+-DRIVES-+--'
                       '-number-'
 

Parameters

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

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

The following are possible values for QIC devices:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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, QIC150, QIC525, QIC1000, QIC2000
See Table 289.

QIC4GB
Specifies that TSM writes data using the 4000 quarter-inch recording format for QIC tapes, without compression. This format results in a cartridge capacity of 4GB.

QIC4GBC
Specifies that TSM writes data using the 4000 quarter-inch recording format for QIC tapes, with compression. This format results in a cartridge capacity of approximately 8GB.

QIC12GB
Specifies that TSM writes data using the 12000 recording format for QIC tapes, without compression. This format results in a cartridge capacity of 12GB on 343-meter tape.

QIC12GBC
Specifies that TSM writes data using the 12000 recording format for QIC tapes, with compression. This format results in a cartridge capacity of approximately 24GB on 343-meter tape. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 24GB.

QIC25GB
Specifies that TSM writes data using the 25000 recording format for QIC tapes, without compression. This format results in a cartridge capacity of 25GB.

QIC25GBC
Specifies that TSM writes data using the 25000 recording format for QIC tapes, with compression. This format results in a cartridge capacity of approximately 50GB.

Table 289. QIC Tape Recording Format Selections


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:TSM cannot use 3M DC300XLP and 3M DC600A tapes.

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

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

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, TSM 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.

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 the default estimated capacity for QIC tapes, see Table 290.

Table 290. TSM Default Estimated Capacity for QIC Tape

Tape Format Estimated Capacity (range)
QIC120 26MB-172MB
QIC150 31MB-207MB
QIC525 65MB-427MB
QIC1000 169MB-1.1GB
QIC2000 2.0GB
QIC4GB 4.0GB
QIC4GBC 4.0GB-8.0GB
QIC12GB 12.0GB
QIC12GBC 12.0GB-24.0GB
QIC25GB 25.0GB
QIC25GBC 25.0GB-50.0GB

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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 -- 3590

Privilege Class

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

Syntax

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

Parameters

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

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

The following are possible values for 3590 devices:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

3590B
Specifies that TSM writes data using the basic (uncompressed) format. This results in a tape capacity of approximately 10GB.

3590C
Specifies that TSM writes data using the compressed format. This results in a tape capacity of approximately 10GB. This format, however, uses the tape drive's hardware compression feature so the actual capacity may be greater depending on the effectiveness of compression.

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

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

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, TSM 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.

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


Table 291. TSM Estimated Capacity for Cartridge Tape

Tape Format Estimated Capacity
3590B 10GB
3590C 10GB (see note)
Note:This format uses the tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 TSM. 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 -- 3570

Privilege Class

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

Syntax

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

Parameters

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

DEVType (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 following are possible values for 3570 devices:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

3570B
Specifies that TSM writes data using the basic (uncompressed) format. This results in a tape capacity of approximately 5GB.

3570C
Specifies that TSM writes data using the compressed format. This results in a tape capacity of approximately 5GB. This format, however, uses the tape drive's hardware compression feature, so the actual capacity may be greater, depending on the effectiveness of compression.

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

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

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, TSM 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.

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 the default estimated capacity for 3570 cartridge tapes, see Table 292.

Table 292. TSM Estimated Capacity for Cartridge Tape

Tape Format Estimated Capacity
3570B 5GB
3570C 5GB (see note)
Note:This format uses the tape drive hardware compression feature, depending on the effectiveness of compression the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 TSM. 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 -- CARTRIDGE

Privilege Class

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

Syntax

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

Parameters

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

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

Possible values for CARTRIDGE devices are:

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

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

3480
Specifies 3480 Basic recording format (18 track).

3480XF
Specifies 3480 Compacted recording format (18 track).

3490B
Specifies 3490 Basic recording format (36 track).

3490C
Specifies 3490 Compacted recording format (36 track).

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

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

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

Values specified for this parameter must meet the following conditions:

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

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.

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

You must specify this value as an integer followed by 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 cartridge tapes, see Table 293.

Table 293. TSM Estimated Capacity for Cartridge Tape

Tape Format Media Type Estimated Capacity
3480 CST 180MB
3480XF CST 180MB (see note)
3490B CST 360MB
3490C CST 360MB (see note)
3490B ECCST 720MB
3490C ECCST 720MB (see note)
Note:This format uses the tape drive hardware compression feature, depending on the effectiveness of compression the actual capacity may be greater than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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=drives
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.

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

UPDATE DEVCLASS -- ECARTRIDGE

Privilege Class

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

Syntax

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

Parameters

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

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

Possible values for ECARTRIDGE devices are:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

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

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

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

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

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

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

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

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

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

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

9840
Specifies a 20GB capacity cartridge with 270 meters (885 feet) of tape recording format.

9840C
Specifies a 80GB capacity cartridge with 270 meters (885 feet) of tape with LZ-1 Enhanced (4:1) compression recording format.

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.

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.

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

Values specified for this parameter must meet the following conditions:

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

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.

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

You must specify this value as an integer followed by 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 cartridge tapes, see Table 294.

Table 294. TSM Estimated Capacity for Cartridge Tape

Tape Format Estimated Capacity
18T 360MB
36T 720MB
SD3A 10GB
SD3B 25GB
SD3C 50GB
9840 20GB
9840C 80GB
Note:Some formats use the tape drive hardware compression feature, depending on the effectiveness of compression the actual capacity may be double or more than the listed value.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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 TSM. 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 -- 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--'
 
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-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.

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.

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

You must specify this value as an integer followed by 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). Specify a capacity appropriate to the particular tape drive being used.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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=drives
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.

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 TSM. 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 -- 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--------------------------->
 
>-----+-------------------------+------------------------------->
      '-FORMAT--=--+-DRIVE---+--'
                   +-650MB---+
                   +-1300MB--+
                   +-2600MB--+
                   '-5200MB--'
 
>-----+---------------------------+----------------------------->
      '-LIBRary--=--library_name--'
 
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
>-----+----------------------------+---------------------------->
      '-MOUNTLimit--=--+-DRIVES-+--'
                       +-number-+
                       '-0------'
 
>-----+-----------------------+---+------------------------+---><
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 

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.

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

Possible values are:

DRIVE
Specifies that TSM selects the highest format that can be supported by the sequential access drive on which a volume is mounted.
Note: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.

650MB
Specifies that TSM writes data to a 650 MB 5.25-inch optical drive.

1300MB
Specifies that TSM writes data to a 1300 MB 5.25-inch optical drive.

2600MB
Specifies that TSM writes data to a 2600 MB 5.25-inch optical drive.

5200MB
Specifies that TSM writes data to a 5200 MB 5.25-inch optical drive.

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.

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.

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.

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

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

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. If the mount request is not satisfied within the specified amount of time, the mount request is canceled. The default value is 60 minutes. You can specify a number from 0 to 9999.

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--'
 
>-----+-----------------------+---+------------------------+---->
      '-MAXCAPacity--=--size--'   '-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.

MAXCAPacity
Specifies the maximum size of any volumes defined to a storage pool categorized by 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, MAXCAPACITY=5M specifies that the maximum capacity for a volume in this device class is 5 megabytes. The default value is 4MB (that is, MAXCAPACITY=4M). The smallest value allowed is 100KB (that is, MAXCAPACITY=100K).

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.

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual library. This parameter is optional and does not apply to automated libraries. 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.

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

Related Commands


Table 295. Commands Related to UPDATE DEVCLASS

Command Description
BACKUP DEVCONFIG Backs up TSM 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 ]