Tivoli Storage Manager for Sun Solaris Administrator's Reference


DEFINE DEVCLASS (Define a Device Class)

Use this command to define a device class to support the sequential access devices at your installation.

Note:The DISK device class is predefined by TSM and cannot be modified with the DEFINE DEVCLASS command.

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

DEFINE DEVCLASS -- FILE

Privilege Class

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

Syntax

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

Parameters

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

DEVType=FILE (Required)
Specifies that the FILE device type is assigned to the device class. FILE indicates that a file is assigned to this device class. When the server needs to access a volume that belongs to this device class, it opens a file and reads or writes file data. A file is a form of sequential access media.

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

MAXCAPacity
Specifies the maximum size of any data storage files defined to a storage pool in 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 (MAXCAPACITY=4M). The minimum value allowed is 100KB (MAXCAPACITY=100K). The maximum value is 128GB (MAXCAPACITY=128G).

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.

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

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

Later, if the server needs to allocate a scratch volume, it creates a new file in this directory. For scratch volumes used to store client data, the file created by the server has a file name extension of .BFS. For scratch volumes used to store export data, a file name extension of .EXP is used. For example, 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

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

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

DEFINE DEVCLASS -- SERVER

Privilege Class

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

Syntax

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

Parameters

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

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

SERVERName (Required)
Specifies the name of the server. The SERVERNAME parameter must match a defined server.
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 (MAXCAPACITY=500M). The minimum value allowed is 100KB (MAXCAPACITY=100K).

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

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.

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

Values specified for this parameter must meet the following conditions:

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

DEFINE DEVCLASS -- 4MM

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--4MM-------->
 
      .-FORMAT--=--DRIVE-----.
>-----+----------------------+--LIBRary--=--library_name-------->
      '-FORMAT--=--+-DRIVE-+-'
                   +-DDS1--+
                   +-DDS1C-+
                   +-DDS2--+
                   +-DDS2C-+
                   +-DDS3--+
                   +-DDS3C-+
                   +-DDS4--+
                   '-DDS4C-'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

The following are possible values for 4mm devices:

DRIVE
Specifies that 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.

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 or 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. However, this format 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. However, this format 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 uses the tape drive hardware compression feature, so the actual capacity may be greater than 24GB. This format only applies to 125-meter tape.

DDS4
Specifies that TSM writes data that uses 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 that uses the DDS-4 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. 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. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

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

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

Values specified for this parameter must meet the following conditions:

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

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 4mm tapes, see Table 48.

Table 48. TSM Default Estimated Capacity for 4mm Tape

Tape Format Estimated Capacity
DDS1 2.0GB
DDS1C 2.0GB (see note)
DDS2 4.0GB
DDS2C 4.0GB (see note)
DDS3 12.0GB
DDS3C 24.0GB (see note)
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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:Specify the number of drives for the library as the MOUNTLIMIT value. For libraries not managed by ADSM (EXTERNAL library type), do not use the DRIVES default for 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).

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

DEFINE DEVCLASS -- 8MM

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--8MM-------->
 
      .-FORMAT--=--DRIVE-----.
>-----+----------------------+--LIBRary--=--library_name-------->
      '-FORMAT--=--+-DRIVE-+-'
                   +-8200--+
                   +-8200C-+
                   +-8500--+
                   +-8500C-+
                   +-8900--+
                   +-8900C-+
                   +-AIT---+
                   '-AITC--'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

Possible values for 8mm 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.

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. However, this format 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, with compression. 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 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. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

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

If you have already established a media label naming convention that supports your current management system, use a volume prefix that conforms to your naming conventions. Values specified for this parameter must meet the following conditions:

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

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 49. 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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

Examples

Task

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

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

DEFINE DEVCLASS -- DLT

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--DLT-------->
 
      .-FORMAT--=--DRIVE------.
>-----+-----------------------+--LIBRary--=--library_name------->
      '-FORMAT--=--+-DRIVE--+-'
                   +-DLT10--+
                   +-DLT10C-+
                   +-DLT15--+
                   +-DLT15C-+
                   +-DLT20--+
                   +-DLT20C-+
                   +-DLT35--+
                   +-DLT35C-+
                   +-DLT40--+
                   '-DLT40C-'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

Note:For upgrades from Enhanced Version 2 to Version 3, you must define the device class with a DEVTYPE parameter of DLT.

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

These are the possible values for DLT 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.

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 20.0GB when using CompacTape III and CompacTape IV cartridges. However, this format uses the tape drive's hardware compression feature so the actual capacity may be greater than 20.0GB depending on the effectiveness of the compression feature.

DLT15
Specifies that 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 30.0GB when using CompacTape III or CompacTape IV cartridges. However, this format uses the tape drive's hardware compression feature so the actual capacity may be greater than 30.0GB depending on the effectiveness of the compression feature.
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 40.0GB when using CompacTape IV cartridges. However, this format uses the tape drive's hardware compression feature so the actual capacity of the cartridge may be greater than 40.0GB depending on the effectiveness of the compression feature.
Note:The DLT20 format can only be used with CompacTape IV cartridges in a DLT4000 and DLT7000 drive.

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 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. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

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

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

Values specified for this parameter must meet the following conditions:

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

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

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

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

DEFINE DEVCLASS -- QIC

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--QIC-------->
 
      .-FORMAT--=--DRIVE--------.
>-----+-------------------------+--LIBRary--=--library_name----->
      '-FORMAT--=--+-DRIVE----+-'
                   +-QIC120---+
                   +-QIC150---+
                   +-QIC525---+
                   +-QIC1000--+
                   +-QIC2GB---+
                   +-QIC2GBC--+
                   +-QIC4GB---+
                   +-QIC4GBC--+
                   +-QIC12GB--+
                   +-QIC12GBC-+
                   +-QIC5010--+
                   +-QIC5010C-+
                   +-QIC25GB--+
                   +-QIC25GBC-+
                   +-QIC50GB--+
                   '-QIC50GBC-'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

The following 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.

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.

QIC120, QIC150, QIC525, QIC1000
See Table 51.

QIC2GB
Specifies that TSM writes data that uses the 2000 quarter-inch recording format. This format results in a cartridge capacity of 2GB.

QIC2GBC
Specifies that TSM writes data that uses the 2000 quarter-inch recording format. This format results in a cartridge capacity of approximately 4GB. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 4GB.

QIC4GB
Specifies that TSM writes data that uses the 4000 quarter-inch recording format. This format results in a cartridge capacity of 4GB.

QIC4GBC
Specifies that TSM writes data that uses the 4000 quarter-inch recording format. This format results in a cartridge capacity of approximately 8GB. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 8GB.

QIC12GB
Specifies that TSM writes data that uses the 12000 recording format. This format results in a cartridge capacity of 12GB on 343-meter tape.

QIC12GBC
Specifies that TSM writes data that uses the 12000 recording format. 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.

QIC5010
Specifies that TSM writes data that uses the 5010 recording format. This format results in a cartridge capacity of 13 to 16GB.

QIC5010C
Specifies that TSM writes data that uses the 5010 recording format, with compression. This format results in a cartridge capacity of approximately 26 to 32GB. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 26 to 32GB.

QIC25GB
Specifies that TSM writes data that uses the 25000 recording format. This format results in a cartridge capacity of 25GB.

QIC25GBC
Specifies that TSM writes data that uses the 25000 recording format, with compression. This format results in a cartridge capacity of approximately 50GB. This format uses the tape drive hardware compression feature, so the actual capacity may be more than 50GB.

QIC50GB
Specifies that TSM writes data using the 50GB recording format for QIC tapes, without compression. This format results in a cartridge capacity of 50GB. This format is specific to the Tandberg SLR100 drive.

QIC50GBC
Specifies that TSM writes data using the 50GBC recording format for QIC tapes, with compression. This format results in a cartridge capacity of approximately 100GB. This format is specific to the Tandberg SLR100 drive.


Table 51. 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. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

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

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

Values specified for this parameter must meet the following conditions:

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

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.

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

Table 52. 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
QIC2GB 2.0GB
QIC2GBC 2.0GB-4.0GB
QIC4GB 4.0GB
QIC4GBC 4.0GB-8.0GB
QIC12GB 12.0GB
QIC12GBC 12.0GB-24.0GB
QIC5010 13.0GB-16.0GB (depends on media)
QIC5010C 26.0GB-32.0GB (depends on media)
QIC25GB 25.0GB
QIC25GBC 25.0GB-50.0GB
QIC50GB 50.0GB
QIC50GBC 100.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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- 3590

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--3590------->
 
      .-FORMAT--=--DRIVE-------.
>-----+------------------------+--LIBRary--=--library_name------>
      '-FORMAT--=--+-DRIVE---+-'
                   +-3590B---+
                   +-3590C---+
                   +-3590E-B-+
                   '-3590E-C-'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

The following 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.

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 20GB. However, this format uses the tape drive's hardware compression feature so the actual capacity may be greater depending on the effectiveness of compression.

3590E-B
Specifies that TSM writes data by using the uncompressed format similar to the 3590B format. This results in a tape capacity of approximately 10GB.

3590E-C
Specifies that TSM writes data by using the compressed format similar to the 3590C format. This results in a tape capacity of approximately 20GB. However, this format uses the tape drive's hardware compression feature so the actual capacity may be greater depending on the effectiveness of compression.

Table 53. 3590 Device Recording Format Selections


Device\Format


3590B


3590C


3590E-B


3590E-C


3590B
Ultra SCSI
3590E


Read/Write
Read/Write
Read


Read/Write
Read/Write
Read


-
-
Read/Write


-
-
Read/Write

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

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

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

Values specified for this parameter must meet the following conditions:

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

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 54. 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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- 3570

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--3570------->
 
      .-FORMAT--=--DRIVE-----.
>-----+----------------------+--LIBRary--=--library_name-------->
      '-FORMAT--=--+-DRIVE-+-'
                   +-3570B-+
                   '-3570C-'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

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.

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

3570C
Specifies that TSM writes data that uses the compressed format. This results in a tape capacity of approximately 10GB. However, this format 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 amount of time, in minutes, to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

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

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

Values specified for this parameter must meet the following conditions:

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

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

Table 55. 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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- CARTRIDGE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--CARTridge-->
 
      .-FORMAT--=--DRIVE------.
>-----+-----------------------+--LIBRary--=--library_name------->
      '-FORMAT--=--+-DRIVE--+-'
                   +-3480---+
                   +-3480XF-+
                   +-3490B--+
                   '-3490C--'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

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

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

3480
Specifies 3480 Basic recording format (18 track).

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

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

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

LIBRary
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 amount of time, in minutes, to retain an idle sequential access volume before dismounting it. This parameter is optional. The default value is 60. You can specify a number from 0 to 9999.

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types, setting this parameter to a low value (for example, two minutes) enhances device sharing between applications.

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 default value is ADSM.

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

Values specified for this parameter must meet the following conditions:

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

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 (ESTCAPACITY=100K).

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

Table 56. 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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

Examples

Task

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

Command:
define devclass square1 devtype=cartridge 
compression=Yes protection=yes

DEFINE DEVCLASS -- ECARTRIDGE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
                                .-FORMAT--=--DRIVE-----.
>-----DEVType--=--ECARTridge----+----------------------+-------->
                                '-FORMAT--=--+-DRIVE-+-'
                                             +-18T---+
                                             +-18TC--+
                                             +-36T---+
                                             +-36TC--+
                                             +-SD3A--+
                                             +-SD3AC-+
                                             +-SD3B--+
                                             +-SD3BC-+
                                             +-SD3C--+
                                             +-SD3CC-+
                                             +-9840--+
                                             '-9840C-'
 
>----LIBRary--=--library_name----------------------------------->
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

DEVType=ECARTridge (Required)
Specifies that the ECARTRIDGE device type is assigned to the device class. ECARTRIDGE indicates that a specific type of cartridge tape device (STK) is assigned to this device class.

Note:For upgrades from Enhanced Version 2 to Version 3, you must define the device class with a DEVTYPE of ECARTRIDGE.

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

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

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 'C' cartridge with 392 meters (1286 feet) of tape with a standard recording format.

SD3CC
Specifies a 50GB 'C' 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 that contains the ECARTRIDGE tape drives that can be used by this device class. For information about defining a library object, see the DEFINE LIBRARY command.

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

This parameter can improve response time for sequential access media mounts by leaving previously mounted volumes online. However, for EXTERNAL library types (that is, a library managed by an external media management system), set this parameter to a low value (for example, two minutes) to enhance device sharing between applications.

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 default value is ADSM.

If you have already established a tape label naming convention that supports your current tape management system, use a tape volume prefix that conforms to your naming conventions.Values specified for this parameter must meet the following conditions:

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

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 cartridge tapes, see Table 57.

Table 57. 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 a tape drive hardware compression feature. Depending on the effectiveness of compression, the actual capacity may be double or more than the listed value.

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

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- GENERICTAPE

Privilege Class

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

Syntax

>>-DEFine DEVclass---device_class_name-------------------------->
 
>-----DEVType--=--GENERICTAPE---LIBRary--=--library_name-------->
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-0------'
 

When using this device type, the server does not recognize either the type of device or the cartridge recording format. Because the server does not recognize the type of device, if an I/O error occurs, error information is less detailed compared to error information for a specific device type (for example, 8mm). When defining devices to the server, do not mix various types of devices within the same device type.

Parameters

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

DEVType=GENERICTAPE (Required)
Specifies that the GENERICTAPE device type is assigned to the device class. GENERICTAPE indicates that the volumes for this device class are used in tape drives supported by the operating system's tape device driver.

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

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

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

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

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

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. The default value is 60 minutes. You can specify a number from 0 to 9999.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- OPTICAL and WORM TYPES

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name--------------------------->
 
                                .-FORMAT--=--DRIVE-------.
>-----DEVType--=--+-OPTical-+---+------------------------+------>
                  '-WORM----'   '-FORMAT--=--+-DRIVE---+-'
                                             +-650MB---+
                                             +-1300MB--+
                                             +-2600MB--+
                                             '-5200MB--'
 
>----LIBRary--=--library_name----------------------------------->
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
                                  .-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
      '-ESTCAPacity--=--size--'   '-MOUNTWait--=--minutes--'
 
      .-MOUNTLimit--=--DRIVES-----.
>-----+---------------------------+----------------------------><
      '-MOUNTLimit--=--+-DRIVES-+-'
                       +-value--+
                       '-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.

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

Possible values are:

OPTical
Specifies that the device class uses two-sided 5.25 inch rewritable optical media.

WORM
Specifies that the device class uses two-sided 5.25 inch write-once read-many (WORM) optical media.

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.

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.

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

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

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

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.

MOUNTLimit
Specifies the maximum number of sequential access volumes that can be simultaneously mounted for the device class. This parameter is optional. The default is DRIVES. You can specify a number from 0 to 256.
Note:For EXTERNAL library types, do not use the DRIVES default for the MOUNTLIMIT value. Specify the number of drives for the library as the MOUNTLIMIT value.

The following are possible values:

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

value
Specifies the maximum number of drives used concurrently in this device class by TSM. This value must never be allowed to exceed the number of drives that are defined and online in the library that services this device class.

0 (zero)
Specifies that no new transactions can gain access to the storage pool.

DEFINE DEVCLASS -- REMOVABLEFILE

Privilege Class

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

Syntax

>>-DEFine DEVclass---device_class_name-------------------------->
 
>-----DEVType--=--REMOVABLEfile---LIBRary--=--library_name------>
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-MOUNTWait--=--60-------.
>-----+------------------------+-------------------------------><
      '-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.

DEVType=REMOVABLEfile (Required)
Specifies that the REMOVABLEFILE device type is assigned to the device class. REMOVABLEFILE indicates that the volume for this device class is CD-ROM. The server opens a file on the media and reads the file data. The media contains data that is copied from the FILE device class to the removable file media. TSM does not write directly to removable file media.

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

When you use CD-ROM media for the REMOVABLEFILE device type, the library type must be MANUAL. You access the media through a mount point, for example, /dev/cdx, where x is a number that is assigned by your operating system. Use the device manufacturer's operating system utilities to format (if necessary) and label the media.

The label on the media must meet the following restrictions:

See "Configuring REMOVABLEFILE Media Devices " in Administrator's Guide for more information.

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

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

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

MOUNTWait
Specifies the maximum number of minutes to wait for a sequential access volume to be mounted in a manual 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.

Related Commands


Table 58. Commands Related to DEFINE DEVCLASS

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


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