Administrator's Reference
Use this command to update a defined device class.
Note: | The DISK device class is predefined by TSM and cannot be modified with the
UPDATE DEVCLASS command.
|
The syntax and parameter descriptions are provided according to the device
type. The syntax and parameter information is presented in the
following order:
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DEVclass---device_class_name-------------------------->
>-----+------------------------+---+-----------------------+---->
'-MOUNTLimit--=--number--' '-MAXCAPacity--=--size--'
>-----+-------------------------------+------------------------><
'-DIRectory--=--directory_name--'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be updated.
- MOUNTLimit
- Specifies the maximum number of files that can be simultaneously open for
input/output. This parameter is optional. You can specify a a
number from 1 to 256.
- MAXCAPacity
- Specifies the maximum size of any data storage files categorized by this
device class. This parameter is optional. You must specify this
value as an integer followed by K (Kilobytes), M
(Megabytes), or G (Gigabytes).
For example, MAXCAPACITY=5M specifies that the maximum capacity for a
volume in this device class is 5 megabytes. The smallest value allowed
is 100KB (that is, MAXCAPACITY=100K). The maximum value is
128GB.
Do not define a MAXCAPACITY value greater than 640M when this file is for
REMOVABLEFILE CDROM support. A value less than a CDROM's usable
space (650MB) allows for a one-to-one match between files from the FILE device
class and copies that are on CDROM.
- DIRectory
- Specifies the directory location of the file used in this device
class. This parameter is optional.
By specifying a directory name, you identify the location where the server
places the files that represent storage volumes for this device class.
While processing the command, the server expands the specified directory name
into its fully qualified form, starting from the root directory.
Later, if the server needs to allocate a scratch volume, it creates a new
file in this directory. For scratch volumes used to store client data,
the file created by the server has a file name extension of
.BFS. For scratch volumes used to store export data, a file name
extension of .EXP is used. For example, if you define a device
class with a DIRECTORY of /TSMSTOR and the server needs a scratch
volume in this device class to store export data, the file that the server
creates may be named /TSMSTOR/00566497.EXP.
Examples
Task
Update a device class named PLAINFILES with a file device type and a
maximum capacity of 50MB.
- Command:
- update devclass plainfiles devtype=file maxcapacity=50m
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDdate DEVclass--device_class_name-------------------------->
>-----+-----------------------------+--------------------------->
'-SERVERName--=--server name--'
>-----+-----------------------+--------------------------------->
'-MAXCAPacity--=--500M--'
>-----+-------------------------------+------------------------->
'-PREFIX--=--+-ADSM----------+--'
'-volume_prefix-'
>-----+------------------------------+-------------------------->
'-RETRYPeriod--=----minutes----'
>-----+--------------------------------+------------------------>
'-RETRYInterval--=----seconds----'
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
>-----+----------------------------+---------------------------><
'-MOUNTLimit--=--+-number-+--'
'-0------'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be updated. The maximum
length of the device class name is 30 characters.
- SERVERName
- Specifies the name of the server. The SERVERNAME parameter must
match a defined server.
Note: | If you change the SERVERNAME of an existing server to a new name, data on the
volumes under the old SERVERNAME will no longer be accessible with this device
class.
|
- MAXCAPacity
- Specifies the maximum size that objects can be when created on the target
server; the default for this value is 500M. This parameter is
optional.
You must specify this value as an integer followed by K
(Kilobytes), M (Megabytes), or G (Gigabytes).
For example, MAXCAPACITY=5M specifies that the maximum capacity for a
volume in this device class is 5 megabytes. The default value is 500M
(that is, MAXCAPACITY=500M). The smallest value allowed is 100KB
(that is, MAXCAPACITY=100K).
- PREFIX
- Specifies the beginning portion of the high-level archive file name on the
target server. This parameter is optional. The maximum length of
this prefix is 8 characters. Values specified for this parameter must
meet the following conditions:
- 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
a TSM qualifier added, is ADSM.volume1.
- RETRYPeriod
- Specifies the retry period in minutes. The retry period is the
interval during which the server attempts to contact a target server if there
is a suspected communications failure. This parameter is
optional. The default value is 10 minutes.
- RETRYInterval
- Specifies the retry interval in seconds. The retry interval is how
often retries are done within a given time period. This parameter is
optional. The default value is 30 seconds.
- MOUNTRetention
- Specifies the number of minutes to retain an idle connection with the
target server before closing the connection. This parameter is
optional. The default value is 60. You can specify a number from
0 to 9999.
This parameter can improve response time for sequential access media mounts
by leaving previously mounted volumes online.
- MOUNTLimit
- Specifies the maximum number of sequential access volumes that can be
simultaneously mounted for the device class. This parameter is
optional. You can specify a number from 0 to 256.
The following are possible values:
- number
- Specifies the maximum number of drives used concurrently in this device
class by TSM. This value must never exceed the number of drives that
are defined and online in the library that services this device class.
- 0 (zero)
- Specifies that no new transactions can gain access to the storage
pool. Any current transaction will continue and complete, but new
transactions will be terminated.
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DEVclass--device_class_name--------------------------->
>-----+-----------------------+---+---------------------------+->
'-FORMAT--=--+-DRIVE-+--' '-LIBRary--=--library_name--'
+-3590B-+
'-3590C-'
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
>-----+------------------------+---+-----------------------+---->
'-PREFIX--=--+-ADSM---+--' '-ESTCAPacity--=--size--'
'-prefix-'
>-----+------------------------+-------------------------------->
'-MOUNTWait--=--minutes--'
>-----+----------------------------+---------------------------><
'-MOUNTLimit--=--+-DRIVES-+--'
+-number-+
'-0------'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be defined.
- FORMAT
- Specifies the recording format to be used when writing data to sequential
access media. This parameter is optional.
The following are possible values for 3590 devices:
- DRIVE
- Specifies that TSM selects the highest format that can be supported by the
sequential access drive on which a volume is mounted.
Note: | Avoid specifying the DRIVE value when a mixture of devices is used within the
same library. For example, if you have drives that support recording
formats superior to other drives in a library, do not specify the
FORMAT=DRIVE option.
|
- 3590B
- Specifies that TSM writes data using the basic (uncompressed)
format. This results in a tape capacity of approximately 10GB.
- 3590C
- Specifies that TSM writes data using the compressed format. This
results in a tape capacity of approximately 10GB. This format, however,
uses the tape drive's hardware compression feature so the actual capacity
may be greater depending on the effectiveness of compression.
- LIBRary
- Specifies the name of the defined library object that contains the tape
drives that can be used by this device class. For information about
defining a library object, see the DEFINE LIBRARY command.
- MOUNTRetention
- Specifies the number of minutes to retain an idle sequential access volume
before dismounting it. This parameter is optional. You can
specify a number from 0 to 9999.
This parameter can improve response time for sequential access media mounts
by leaving previously mounted volumes online.
- PREFIX
- Specifies the high level qualifier of the data set name that the server
writes into the sequential access media labels. For each sequential
access volume assigned to this device class, TSM uses this prefix to create
the data set name. This parameter is optional. The maximum
length of this prefix is 8 characters.
If you have already established a media label naming convention that
supports your current management system, consider using a volume prefix that
conforms to your naming conventions.
- ESTCAPacity
- Specifies the estimated capacity for the sequential access volumes
categorized by this device class. This parameter is optional.
You can specify this parameter if the default estimated capacity for the
device class is inaccurate due to compression of data.
You must specify this value as an integer followed by K
(Kilobytes), M (Megabytes), or G (Gigabytes).
For example, ESTCAPACITY=5M specifies that the estimated capacity for a
volume in this device class is 5 megabytes. The smallest value allowed
is 100KB (that is, ESTCAPACITY=100K).
Table 278. TSM Estimated Capacity for Cartridge Tape
Tape Format
| Estimated Capacity
|
3590B
| 10GB
|
3590C
| 10GB (see note)
|
Note: | This format uses the tape drive hardware compression feature.
Depending on the effectiveness of compression, the actual capacity may be
greater than the listed value.
|
|
- MOUNTWait
- Specifies the maximum number of minutes to wait for a sequential access
volume to be mounted in a manual library. This parameter is optional
and does not apply to automated libraries. If the mount request is not
satisfied within the specified amount of time, the mount request is
canceled. You can specify a number from 0 to 9999.
- MOUNTLimit
- Specifies the maximum number of sequential access volumes that can be
simultaneously mounted for the device class. This parameter is
optional. You can specify a number from 0 to 256.
The following are possible values:
- DRIVES
- Specifies that every time a mount point is allocated, the number of drives
defined to the library is used to calculate the true mountlimit value
(including online status).
- number
- Specifies the maximum number of drives used concurrently in this device
class by TSM. This value must never exceed the number of drives that
are defined and online in the library that services this device class.
- 0 (zero)
- Specifies that no new transactions can gain access to the storage
pool. Any current transaction will continue and complete, but new
transactions will be terminated.
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DEVclass---device_class_name----DEVType--=--3570------>
>-----+-----------------------+---+---------------------------+->
'-FORMAT--=--+-DRIVE-+--' '-LIBRary--=--library_name--'
+-3570B-+
'-3570C-'
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
>-----+------------------------+---+-----------------------+---->
'-PREFIX--=--+-ADSM---+--' '-ESTCAPacity--=--size--'
'-prefix-'
>-----+------------------------+-------------------------------><
'-MOUNTWait--=--minutes--'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be defined.
- DEVType (Required)
- Specifies the 3570 device type is assigned to the device class. The
3570 indicates that IBM 3570 cartridge tape devices are assigned to this
device class.
- FORMAT
- Specifies the recording format to be used when writing data to sequential
access media. This parameter is optional.
The following are possible values for 3570 devices:
- DRIVE
- Specifies that TSM selects the highest format that can be supported by the
sequential access drive on which a volume is mounted.
- 3570B
- Specifies that TSM writes data using the basic (uncompressed)
format. This results in a tape capacity of approximately 5GB.
- 3570C
- Specifies that TSM writes data using the compressed format. This
results in a tape capacity of approximately 5GB. This format, however,
uses the tape drive's hardware compression feature, so the actual capacity
may be greater, depending on the effectiveness of compression.
- LIBRary
- Specifies the name of the defined library object that contains the tape
drives that can be used by this device class. For information about
defining a library object, see the DEFINE LIBRARY command.
- MOUNTRetention
- Specifies the number of minutes, to retain an idle sequential access
volume before dismounting it. This parameter is optional. You
can specify a number from 0 to 9999.
This parameter can improve response time for sequential access media mounts
by leaving previously mounted volumes online.
- PREFIX
- Specifies the high level qualifier of the data set name that the server
writes into the sequential access media labels. For each sequential
access volume assigned to this device class, TSM uses this prefix to create
the data set name. This parameter is optional. The maximum
length of this prefix is 8 characters.
If you have already established a media label naming convention that
supports your current management system, consider using a volume prefix that
conforms to your naming conventions.
- ESTCAPacity
- Specifies the estimated capacity for the sequential access volumes
categorized by this device class. This parameter is optional.
You can specify this parameter if the default estimated capacity for the
device class is inaccurate due to compression of data.
You must specify this value as an integer followed by K
(Kilobytes), M (Megabytes), or G (Gigabytes).
For example, ESTCAPACITY=5M specifies that the estimated capacity for a
volume in this device class is 5 megabytes. The smallest value allowed
is 100KB (that is, ESTCAPACITY=100K).
For more information on the default estimated capacity for 3570 cartridge
tapes, see Table 279.
Table 279. TSM Estimated Capacity for Cartridge Tape
Tape Format
| Estimated Capacity
|
3570B
| 5GB
|
3570C
| 5GB (see note)
|
Note: | This format uses the tape drive hardware compression feature, depending on
the effectiveness of compression the actual capacity may be greater than the
listed value.
|
|
- MOUNTWait
- Specifies the maximum number of minutes to wait for a sequential access
volume to be mounted in a manual library. This parameter is optional
and does not apply to automated libraries. If the mount request is not
satisfied within the specified amount of time, the mount request is
canceled. You can specify a number from 0 to 9999.
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DEVclass---device_class_name-------------------------->
>-----+---------------------------+----------------------------->
'-LIBRary--=--library_name--'
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
>-----+-----------------------+---+------------------------+---->
'-ESTCAPacity--=--size--' '-MOUNTWait--=--minutes--'
>-----+----------------------------+---------------------------><
'-MOUNTLimit--=--+-DRIVES-+--'
+-number-+
'-0------'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be updated.
- LIBRary
- Specifies the name of the defined library object that contains the tape
drives used by this device class. This parameter is optional.
For information about defining a library object, see the DEFINE LIBRARY
command.
- MOUNTRetention
- Specifies the number of minutes to retain an idle sequential access volume
before dismounting it. This parameter is optional. You can
specify a number from 0 to 9999.
This parameter can improve response time for sequential access media mounts
by leaving previously mounted volumes online.
- ESTCAPacity
- Specifies the estimated capacity for the sequential access volumes
categorized by this device class. This parameter is optional.
You must specify this value as an integer followed by K
(Kilobytes), M (Megabytes), or G (Gigabytes).
For example, ESTCAPACITY=5M specifies that the estimated capacity for a
volume in this device class is 5 megabytes. The smallest value allowed
is 100KB (that is, ESTCAPACITY=100K). Specify a capacity appropriate
to the particular tape drive being used.
- MOUNTWait
- Specifies the maximum number of minutes to wait for a sequential access
volume to be mounted in a manual library. This parameter is optional
and does not apply to automated libraries. If the mount request is not
satisfied within the specified amount of time, the mount request is
canceled. You can specify a number from 0 to 9999.
- MOUNTLimit=drives
- Specifies the maximum number of sequential access volumes that can be
simultaneously mounted for the device class. This parameter is
optional. You can specify a number from 0 to 256.
The following are possible values:
- DRIVES
- Specifies that every time a mount point is allocated, the number of drives
defined to the library is used to calculate the true mountlimit value
(including online status).
- number
- Specifies the maximum number of drives used concurrently in this device
class by TSM. This value must never exceed the number of drives that
are defined and online in the library that services this device class.
- 0 (zero)
- Specifies that no new transactions can gain access to the storage
pool. Any current transaction will continue and complete but new
transactions will be terminated.
Privilege Class
To issue this command, you must have system privilege or unrestricted
storage privilege.
Syntax
>>-UPDate DEVclass---device_class_name-------------------------->
>-----+---------------------------+----------------------------->
'-LIBRary--=--library_name--'
>-----+-----------------------------+--------------------------->
'-MOUNTRetention--=--minutes--'
>-----+-----------------------+---+------------------------+---->
'-MAXCAPacity--=--size--' '-MOUNTWait--=--minutes--'
>-----+----------------------------+---------------------------><
'-MOUNTLimit--=--+-DRIVES-+--'
+-number-+
'-0------'
Parameters
- device_class_name (Required)
- Specifies the name of the device class to be updated.
- LIBRary
- Specifies the name of the defined library object that contains the
removable media drives used by this device class. This parameter is
optional. For information about defining a library object, see the
DEFINE LIBRARY command.
- MOUNTRetention
- Specifies the number of minutes to retain an idle sequential access volume
before dismounting it. This parameter is optional. You can
specify a number from 0 to 9999.
This parameter can improve response time for sequential access media mounts
by leaving previously mounted volumes online.
- MAXCAPacity
- Specifies the maximum size of any volumes defined to a storage pool
categorized by this device class. This parameter is optional.
You must specify this value as an integer followed by K
(Kilobytes), M (Megabytes), or G (Gigabytes).
For example, MAXCAPACITY=5M specifies that the maximum capacity for a
volume in this device class is 5 megabytes. The default value is 4MB
(that is, MAXCAPACITY=4M). The smallest value allowed is 100KB (that
is, MAXCAPACITY=100K).
Because the server opens only one file per physical removable medium,
specify a capacity such that the one file makes full use of your media
capacity.
- MOUNTWait
- Specifies the maximum number of minutes to wait for a sequential access
volume to be mounted in a manual library. This parameter is optional
and does not apply to automated libraries. If the mount request is not
satisfied within the specified amount of time, the mount request is
canceled. You can specify a number from 0 to 9999.
- MOUNTLimit
- Specifies the maximum number of sequential access volumes that can be
simultaneously mounted for the device class. This parameter is
optional. You can specify a number from 0 to 256.
The following are possible values:
- DRIVES
- Specifies that every time a mount point is allocated, the number of drives
defined to the library is used to calculate the true mountlimit value
(including online status).
- number
- Specifies the maximum number of drives used concurrently in this device
class by TSM. This value must never exceed the number of drives that
are defined and online in the library that services this device class.
- 0 (zero)
- Specifies that no new transactions can gain access to the storage
pool. Any current transaction will continue and complete but new
transactions will be terminated.
Table 280. Commands Related to UPDATE DEVCLASS
Command
| Description
|
BACKUP DEVCONFIG
| Backs up TSM device information to a file.
|
DEFINE DEVCLASS
| Defines a device class.
|
DEFINE LIBRARY
| Defines an automated or manual library.
|
DELETE DEVCLASS
| Deletes a device class name.
|
QUERY DEVCLASS
| Displays information about device classes.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]