Administrator's Reference
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:
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----------------.
>-----+---------------------------------+----------------------->
'-MOUNTLimit--=--mountlimitvalue--'
.-MAXCAPacity--=--4M----.
>-----+-----------------------+--------------------------------->
'-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
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-DEFine DEVclass--device_class_name----DEVType--=--SERVER----->
.-MAXCAPacity--=--500M----.
>-----SERVERName--=--server_name----+-------------------------+->
'-MAXCAPacity--=--maxcap--'
.-MOUNTLimit--=--1----------------.
>-----+---------------------------------+----------------------->
'-MOUNTLimit--=--mountlimitvalue--'
.-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
.-PREFIX--=--ADSM----------.
>-----+--------------------------+------------------------------>
'-PREFIX--=--+-ADSM------+-'
'-volprefix-'
.-RETRYPeriod--=--10-------------------.
>-----+--------------------------------------+------------------>
'-RETRYPeriod--=--retryvalue(minutes)--'
.-RETRYInterval--=--30-------------------.
>-----+----------------------------------------+---------------><
'-RETRYInterval--=--retryvalue(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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a high level archive file name using the default prefix (with
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.
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----------+-'
+-mountlimitvalue-+
'-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-4C recording
format. 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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 49.
Table 49. 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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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----------+-'
+-mountlimitvalue-+
'-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.
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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 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 mountlimit value
(including online status).
- mountlimitvalue
- 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
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-+
+-DLT30--+
+-DLT30C-+
+-DLT35--+
+-DLT35C-+
+-DLT40--+
'-DLT40C-'
.-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
.-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
'-PREFIX--=--+-ADSM----------+-'
'-tapevolprefix-'
.-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
'-ESTCAPacity--=--size--' '-MOUNTWait--=--minutes--'
.-MOUNTLimit--=--DRIVES--------------.
>-----+------------------------------------+-------------------><
'-MOUNTLimit--=--+-DRIVES----------+-'
+-mountlimitvalue-+
'-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.
|
- DLT30
- Specifies that TSM writes data using the DLT30 recording format.
This results in a tape capacity of approximately 30.0GB when using
CompacTape IV cartridges.
Note: | DLT30 and DLT30C can only be used with CompacTape IV cartridges.
|
- DLT30C
- Specifies that TSM writes data using the DLT30C recording format.
This results in a tape capacity of approximately 70.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 70.0GB depending on the effectiveness of
the compression feature.
Note: | DLT30 and DLT30C 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. However, this format ses 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 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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 51. 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 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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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--+
+-QIC5010--+
+-QIC5010C-+
+-QIC4GB---+
+-QIC4GBC--+
+-QIC12GB--+
+-QIC12GBC-+
+-QIC25GB--+
'-QIC25GBC-'
.-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
.-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
'-PREFIX--=--+-ADSM----------+-'
'-tapevolprefix-'
.-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
'-ESTCAPacity--=--size--' '-MOUNTWait--=--minutes--'
.-MOUNTLimit--=--DRIVES--------------.
>-----+------------------------------------+-------------------><
'-MOUNTLimit--=--+-DRIVES----------+-'
+-mountlimitvalue-+
'-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 52.
- 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
2GB.
- 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.
- 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 5010C recording
format. This format results in a cartridge capacity of approximately 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. This format results in a cartridge capacity of approximately
50GB.
Table 52. 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
|
-
-
-
-
-
-
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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 53.
Table 53. 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
|
- 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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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-'
.-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
.-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
'-PREFIX--=--+-ADSM----------+-'
'-tapevolprefix-'
.-MOUNTWait--=--60-------.
>-----+-----------------------+---+------------------------+---->
'-ESTCAPacity--=--size--' '-MOUNTWait--=--minutes--'
.-MOUNTLimit--=--DRIVES--------------.
>-----+------------------------------------+-------------------><
'-MOUNTLimit--=--+-DRIVES----------+-'
+-mountlimitvalue-+
'-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 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 previouslyvolumes 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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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----------+-'
+-mountlimitvalue-+
'-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 5GB. 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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
An example of a tape volume data set name using the default prefix (with
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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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----------+-'
+-mountlimitvalue-+
'-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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
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 mountlimit value
(including online status).
- mountlimitvalue
- 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
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----------+-'
+-mountlimitvalue-+
'-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 '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 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:
- The value is to be made up of qualifiers, which can contain up to 8
characters (including periods). For example, the following value would
be acceptable:
AB.CD2.E
- The qualifiers must be separated by a single period.
- The first letter of each qualifier must be alphabetical or national
(@,#,$), followed by alphabetical, national, hyphen, or numeric
characters.
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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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----------+-'
+-mountlimitvalue-+
'-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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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----------+-'
+-mountlimitvalue-+
'-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 mountlimit value
(including online status).
- mountlimitvalue
- 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.
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:
- No more than 11 characters
- Same name for file name and volume label
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.
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 ]