Administrator's Reference


DEFINE DEVCLASS (Define a Device Class)

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

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

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

DEFINE DEVCLASS -- FILE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--FILE------->
 
      .-MOUNTLimit--=--2----------------.
>-----+---------------------------------+----------------------->
      '-MOUNTLimit--=--mountlimitvalue--'
 
      .-PREFIX--=--ADSM-----------.   .-MAXCAPacity--=--1M----.
>-----+---------------------------+---+-----------------------+->
      '-PREFIX--=--tapevolprefix--'   '-MAXCAPacity--=--size--'
 
      .-UNIT--=--""--------.   .-VOLSER--=--""------.
>-----+--------------------+---+--------------------+----------><
      '-UNIT--=--unitname--'   '-VOLSER--=--volser--'
 

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.

MOUNTLimit
Specifies the maximum number of FILE volumes that can be concurrently open at any one time for this device class. This parameter is optional. The default value is 2. For 3995 devices emulating 3390 devices, this value should not be set higher than the number of concurrent input/output streams possible on the media storing the TSM volumes.

Because FILE volumes are classified as sequential media, processing conventions normally associated with sequential media are followed. Specifically, this means that mount limits are observed, and that data that has expired leaves holes in the volume and volumes can only be recycled through either the MOVE DATA command or the volume reclamation process. Only one process can read or write to a volume at a time. This has important implications for clients backing up directly to FILE media. The number of active clients is limited to the value specified in the MOUNTLIMIT parameter for the device class.

The value you specify in this parameter is important if there is a significant penalty switching from one volume to another (switching can take place when using 3995 devices emulating 3390 devices). The value you specify in this parameter should be no higher than the number of physical drives available on the device.

See the Usage Notes for more information on FILE volumes.

PREFIX
Specifies the high-level qualifier of the data set name that is used to allocate scratch volume data sets. For all scratch file volumes created in this device class, TSM uses this prefix to create the data set name. This parameter is optional. The default is ADSM.

Values specified for this parameter must meet the following conditions:

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

If you have established a data set naming convention, consider using a file prefix that conforms to your naming conventions.

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

UNIT
Specifies the unit name that indicates on which device to place the FILE volumes. You can specify any unit name that is known to your MVS installation. The maximum length of the unit name is 8 characters. The default value is a null string (""). This parameter is optional.

VOLSER
Specifies the volume serial number of a DASD on which to place FILE volumes. The volser can be any volume serial number known to your MVS installation. The maximum length of the volser is 6 characters. The default value is a null string (""). This parameter is optional.
Note:Specifying a value for this parameter requires you to also specify a value for the UNIT parameter.

DEFINE DEVCLASS -- SERVER

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVType--=--SERVER----->
 
                                    .-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:

An example of a high level archive file name using the default prefix (with the TSM qualifier added) is ADSM.volume1.

RETRYPeriod
Specifies the retry period in minutes. The retry period is the interval during which the server attempts to contact a target server if there is a suspected communications failure. This parameter is optional. The default value is 10 minutes.

RETRYInterval
Specifies the retry interval in seconds. The retry interval is how often retries are done within a given time period. This parameter is optional. The default value is 30 seconds.

DEFINE DEVCLASS -- 3590

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVtype--=--3590------->
 
      .-MOUNTLimit--=--2----------------.
>-----+---------------------------------+----------------------->
      '-MOUNTLimit--=--mountlimitvalue--'
 
      .-MOUNTWait--=--60-------.
>-----+------------------------+-------------------------------->
      '-MOUNTWait--=--minutes--'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
      .-MAXCAPacity--=--0-------.
>-----+-------------------------+---+-----------------------+--->
      '-MAXCAPacity--=--maxcap--'   '-ESTCAPacity--=--size--'
 
>-----+-----------------------------+---+---------------------+->
      '-EXPiration--=--+-yyddd---+--'   '-RETention--=--days--'
                       '-yyyyddd-'
 
      .-COMPression--=--Yes-----.
>-----+-------------------------+------------------------------->
      '-COMPression--=--+-Yes-+-'
                        '-No--'
 
      .-PROtection--=--No------------.   .-UNIT--=--3590------.
>-----+------------------------------+---+--------------------+-><
      '-PROtection--=--+-No--------+-'   '-UNIT--=--unitname--'
                       +-Yes-------+
                       '-Automatic-'
 

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 3590 cartridge tape devices are assigned to the device class.

MOUNTLimit
Specifies the maximum number of tape volumes that can be simultaneously mounted for a device class. This parameter is optional. The default value is 2. You can specify a number from 1 to 256.

You cannot share drives between device classes (that is, the sum of your mount limits should not be more than the number of physical drives allocated to TSM).

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.

MOUNTRetention
Specifies the amount of time, in minutes, to retain an idle tape volume before dismounting it. Mountretention time begins after the idle time-out period has expired. 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 tape mounts by leaving the previously mounted volume online.

PREFIX
Specifies the high-level qualifier of the data set name in the tape labels. For all tape volumes assigned to this device class, TSM uses this prefix to create the data set name. This parameter is optional. The default value is ADSM. Values specified for this parameter must meet the following conditions:

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

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

MAXCAPacity
Specifies the maximum amount of data TSM can store in the volumes categorized by this device class. This parameter is optional. The default is 0.

The value you specify for this parameter (other than 0) is used to determine maximum capacity of the volume. If you do not specify a value, the volume will fill to the physical end of the volume. If the default method does not meet your needs, set the value to a nonzero value less than the maximum capacity of the tape to avoid an end-of-tape situation. If MAXCAPACITY is specified and TSM detects an end-of-tape situation for the specified volume, a warning message is issued and the tape is treated as full.

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 this device class is 5 megabytes.

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

This value is ignored if you specify a value other than 0 in the MAXCAPACITY parameter. If TSM uses the value specified in the ESTCAPACITY parameter, this value does not determine the amount of data stored on the volume, but only determines the usage before the volume is filled. After a volume is full, the actual amount of data stored on the tape is used for these calculations.

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

The default estimated capacity for 3590 tapes is 9G.

EXPiration
Specifies the expiration date that is placed on the tape labels for this device class. This parameter is optional. There is no default value.

If you specify this parameter, enter the expiration date when TSM no longer requires the tape. TSM does not use this information, however; this information is passed to the operating system for use by MVS or tape management systems. For additional information, see the Administrator's Guide.

If you specify this parameter, you cannot specify the RETENTION parameter. Possible values are:

yyddd
Specifies the expiration date for this device class, in YYDDD format.

yyyyddd
Specifies the expiration date for this device class, in YYYYDDD format.

RETention
Specifies the number of days to retain the tape. This parameter is optional. You can specify a number from 1 to 9999. If you specify this parameter, enter the number of days that equals the length of time TSM is expected to use the tape. TSM does not use this information, but the information is passed to the operating system for use by MVS or tape management systems. For additional information, see the Administrator's Guide.

If you specify this parameter, you cannot specify the EXPIRATION parameter.

COMPression
Specifies whether the device class is to exploit file compression. This parameter is optional. The default value is YES.

Possible values are:

Yes
Specifies that the data for each tape volume is compressed.

No
Specifies that the data for each tape volume is not compressed.

PROtection
Specifies whether RACF, if installed, protects volumes assigned to this device class. If protection is provided, RACF profiles are created for the volumes. This parameter is optional. The default value is NO. Possible values are:

No
Specifies that RACF does not protect 3590 volumes assigned to this device class.

Yes
Specifies that RACF protects 3590 volumes assigned to this device class. RACF profiles are created for volumes when TSM first uses the volumes, but the profiles are not deleted when volumes are deleted from TSM. Profiles will have to be manually deleted.

Automatic
Specifies that RACF protects 3590 volumes assigned to this device class. RACF profiles are deleted when volumes are deleted from TSM.
Important:If you specify PROTECTION=AUTOMATIC, volumes deleted from TSM will no longer be RACF-protected and the data on these volumes will be accessible by other users.

If you specify PROTECTION=AUTOMATIC, TSM will issue RACROUTE commands to delete profiles when a volume is deleted from TSM. The deletion commands issued will depend on the current system settings for TAPEVOL and TAPEDSN. If the system settings are changed, TSM may not delete existing profiles. See the following note for more information on this parameter.

Note:If sensitive data is stored on volumes assigned to this device class, it is recommended that PROTECTION=YES be specified and that RACF profiles be manually deleted after tape cartridges have been erased.

The profiles created when you specify PROTECTION=YES or PROTECTION=AUTOMATIC depend on the system RACF settings. The protection provided is the same as using PROTECT=YES in JCL. If RACF is active and both TAPEVOL and TAPEDSN are inactive, allocation of tapes will fail. See RACF Security Administrator's Guide, SC28-1340 for more information on the TAPEVOL and TAPEDSN settings and the profiles that will be created when they are active.

Profile creation and deletion occur based on the protection setting when the volume is first used and when it is deleted. TSM does not attempt to create profiles for volumes that it has already used. If protection is set to AUTOMATIC, TSM will attempt to delete profiles when volumes are deleted.

It is not recommended that you change protection to AUTOMATIC for a device class that has been set to NO. Volumes without profiles may exist and error messages will be generated when volumes are deleted. If a different value is required, a new device class should be defined.

UNIT
Specifies an esoteric unit name to specify a group of tape devices that support 3590 tape. This parameter is optional. The default value is 3590. This name can be as many as 8 characters.

DEFINE DEVCLASS -- CARTRIDGE

Privilege Class

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

Syntax

>>-DEFine DEVclass--device_class_name----DEVtype--=--CARTridge-->
 
      .-MOUNTLimit--=--2----------------.
>-----+---------------------------------+----------------------->
      '-MOUNTLimit--=--mountlimitvalue--'
 
      .-MOUNTWait--=--60-------.
>-----+------------------------+-------------------------------->
      '-MOUNTWait--=--minutes--'
 
      .-MOUNTRetention--=--60-------.
>-----+-----------------------------+--------------------------->
      '-MOUNTRetention--=--minutes--'
 
      .-PREFIX--=--ADSM--------------.
>-----+------------------------------+-------------------------->
      '-PREFIX--=--+-ADSM----------+-'
                   '-tapevolprefix-'
 
      .-MAXCAPacity--=--0-------.
>-----+-------------------------+---+-----------------------+--->
      '-MAXCAPacity--=--maxcap--'   '-ESTCAPacity--=--size--'
 
>-----+-----------------------------+---+---------------------+->
      '-EXPiration--=--+-yyddd---+--'   '-RETention--=--days--'
                       '-yyyyddd-'
 
      .-COMPression--=--Yes-----.
>-----+-------------------------+------------------------------->
      '-COMPression--=--+-Yes-+-'
                        '-No--'
 
      .-PROtection--=--No------------.   .-UNIT--=--3480------.
>-----+------------------------------+---+--------------------+-><
      '-PROtection--=--+-No--------+-'   '-UNIT--=--unitname--'
                       +-Yes-------+
                       '-Automatic-'
 

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 the CARTRIDGE device type is assigned to the device class. CARTRIDGE indicates that cartridge tape devices are assigned to the device class.

MOUNTLimit
Specifies the maximum number of tape volumes that can be simultaneously mounted for a device class. This parameter is optional. The default value is 2. You can specify a number from 1 to 256.

You cannot share drives between device classes (that is, the sum of your mount limits should not be more than the number of physical drives allocated to TSM).

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.

MOUNTRetention
Specifies the amount of time, in minutes, to retain an idle tape volume before dismounting it. Mountretention time begins after the idle time-out period has expired. 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 tape mounts by leaving the previously mounted volume online.

PREFIX
Specifies the high-level qualifier of the data set name in the tape labels. For all tape volumes assigned to this device class, TSM uses this prefix to create the data set name. This parameter is optional. The default value is ADSM. Values specified for this parameter must meet the following conditions:

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

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

MAXCAPacity
Specifies the maximum amount of data TSM can store in the volumes categorized by this device class. This parameter is optional. The default is 0.

The value you specify for this parameter (other than 0) is used to determine maximum capacity of the volume. If you do not specify a value and 0 is used, TSM uses a default method based on IBM 3480 and 3490E device characteristics using IBM tapes. If this default method does not meet your needs, set the value to a nonzero value less than the maximum capacity of the tape to avoid an end-of-tape situation. If TSM detects an end-of-tape situation for the specified volume, a warning message is issued and the tape is treated as full.

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 this device class is 5 megabytes.

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

This value is ignored if you specify a value other than 0 in the MAXCAPACITY parameter. If TSM uses the value specified in the ESTCAPACITY parameter, this value does not determine the amount of data stored on the volume, but only determines the usage before the volume is filled. After a volume is full, the actual amount of data stored on the tape is used for these calculations.

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

Table 45. TSM Estimated Capacity for Cartridge Tape

Tape Format Media Type Estimated Capacity
3480 (Not applicable) 180MB
3480XF (Not applicable) 180MB
3490-A01 CST 180MB
3490B CST 360MB
3490C CST 360MB
3490B ECCST 720MB
3490C ECCST 720MB
Note:

3490 Base devices include models A01, A02, A10, A20, B02, B04, B20, B40, D41, D42 3490 E devices include models C1A, C2A, C10, C11, C22

EXPiration
Specifies the expiration date that is placed on the tape labels for this device class. This parameter is optional. There is no default value.

If you specify this parameter, enter the expiration date when TSM no longer requires the tape. TSM does not use this information, however; this information is passed to the operating system for use by MVS or tape management systems. For additional information, see the Administrator's Guide.

If you specify this parameter, you cannot specify the RETENTION parameter. Possible values are:

yyddd
Specifies the expiration date for this device class, in YYDDD format.

yyyyddd
Specifies the expiration date for this device class, in YYYYDDD format.

RETention
Specifies the number of days to retain the tape. This parameter is optional. You can specify a number from 1 to 9999. If you specify this parameter, enter the number of days that equals the length of time TSM is expected to use the tape. TSM does not use this information, however; this information is passed to the operating system for use by MVS or tape management systems. For additional information, see the Administrator's Guide.

If you specify this parameter, you cannot specify the EXPIRATION parameter.

COMPression
Specifies whether the device class is to exploit file compression. This parameter is optional. The default value is YES.

If your tape devices have IDRC, then data can be compressed when written to CARTRIDGE tape devices. If your tape devices do not have IDRC, then the compression attribute is ignored and data is not compressed.

Also, if your tape volumes can be moved to other physical sites, ensure that the compressed data can be read at the other sites. If the other sites cannot read compressed data, you want to specify COMPRESSION=NO. Possible values are:

Yes
Specifies that the data for each tape volume is compressed.

No
Specifies that the data for each tape volume is not compressed.

PROtection
Specifies whether RACF, if installed, protects volumes assigned to this device class. If protection is provided, RACF profiles are created for the volumes. This parameter is optional. The default value is NO. Possible values are:

No
Specifies that RACF does not protect CARTRIDGE volumes assigned to this device class.

Yes
Specifies that RACF protects CARTRIDGE volumes assigned to this device class. RACF profiles are created for volumes when TSM first uses the volumes, but the profiles are not deleted when volumes are deleted from TSM. Profiles will have to be manually deleted.

Automatic
Specifies that RACF protects CARTRIDGE volumes assigned to this device class. RACF profiles are deleted when volumes are deleted from TSM.
Important:If you specify PROTECTION=AUTOMATIC, volumes deleted from TSM will no longer be RACF-protected and the data on these volumes will be accessible by other users.

If you specify PROTECTION=AUTOMATIC, TSM will issue RACROUTE commands to delete profiles when a volume is deleted from TSM. The deletion commands issued will depend on the current system settings for TAPEVOL and TAPEDSN. If the system settings are changed, TSM may not delete existing profiles. See the following note for more information on this parameter.

Note:If sensitive data is stored on volumes assigned to this device class, it is recommended that PROTECTION=YES be specified and that RACF profiles be manually deleted after tape cartridges have been erased.

The profiles created when you specify PROTECTION=YES or PROTECTION=AUTOMATIC depend on the system RACF settings. The protection provided is the same as using PROTECT=YES in JCL. If RACF is active and both TAPEVOL and TAPEDSN are inactive, allocation of tapes will fail. See RACF Security Administrator's Guide, SC28-1340 for more information on the TAPEVOL and TAPEDSN settings and the profiles that will be created when they are active.

Profile creation and deletion occur based on the protection setting when the volume is first used and when it is deleted. TSM does not attempt to create profiles for volumes that it has already used. If protection is set to AUTOMATIC, TSM will attempt to delete profiles when volumes are deleted.

It is not recommended that you change protection to AUTOMATIC for a device class that has been set to NO. Volumes without profiles may exist and error messages will be generated when volumes are deleted. If a different value is required, a new device class should be defined.

UNIT
Specifies an esoteric unit name to specify a group of tape devices that support Cartridge System tape. This parameter is optional. The default value is 3480. This name can be as many as 8 characters.

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

Related Commands


Table 46. Commands Related to DEFINE DEVCLASS

Command Description
BACKUP DEVCONFIG Backs up TSM device information to a file.
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 ]