IBM Tivoli Storage Manager, Version 7.1

DEFINE DEVCLASS (Define a 3590 device class for z/OS media server)

To use a z/OS® media server to access 3590 devices, you must define a 3590 device class. In the device class definition, specify a library that was defined with the LIBTYPE=ZOSMEDIA parameter.

Privilege class

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

Syntax


>>-DEFine DEVclass--device_class_name--------------------------->

>--LIBRary--=--zos_media_library--DEVType--=--3590-------------->

                               .-ESTCAPacity--=--9G-------.   
>--+------------------------+--+--------------------------+----->
   '-FORMAT--=--+-DRIVE---+-'  '-ESTCAPacity--=----size---'   
                +-3590B---+                                   
                +-3590C---+                                   
                +-3590E-B-+                                   
                +-3590E-C-+                                   
                +-3590H-B-+                                   
                '-3590H-C-'                                   

   .-PREFIX--=--ADSM-------------------.   
>--+-----------------------------------+------------------------>
   '-PREFIX--=--+-ADSM---------------+-'   
                '-tape_volume_prefix-'     

   .-MOUNTRetention--=--60------.  .-MOUNTWait--=--60------.   
>--+----------------------------+--+-----------------------+---->
   '-MOUNTRetention--=--minutes-'  '-MOUNTWait--=--minutes-'   

   .-MOUNTLimit--=--2----------.  .-COMPression--=--Yes-----.   
>--+---------------------------+--+-------------------------+--->
   '-MOUNTLimit--=--+-DRIVES-+-'  '-COMPression--=--+-Yes-+-'   
                    +-number-+                      '-No--'     
                    '-0------'                                  

>--+------------------------+----------------------------------->
   +-EXPiration--=--yyyyddd-+   
   '-RETention--=--days-----'   

   .-PROtection--=--No------------.  .-UNIT--=--3590------.   
>--+------------------------------+--+--------------------+----><
   '-PROtection--=--+-No--------+-'  '-UNIT--=--unit_name-'   
                    +-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.

LIBRary (Required)

Specifies the name of a library that has been defined with the LIBTYPE=ZOSMEDIA parameter. The library and the tape drives that can be used by this device class are controlled by the z/OS media server.

For information about defining a library, see the DEFINE LIBRARY command.

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.

Restriction: The z/OS media server supports 256 KB data blocks when writing to 3590 tape drives. Verify that your hardware supports this capability.

FORMAT

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

See the following table for the recording formats.

Table 1. Recording formats for 3590
Format	Description
3590B	Uncompressed (basic) format
3590C	Compressed format
3590E-B	Uncompressed (basic) format, similar to the 3590B format
3590E-C	Compressed format, similar to the 3590C format
3590H-B	Uncompressed (basic) format, similar to the 3590B format
3590H-C	Compressed format, similar to the 3590C format
Note: If the format uses the tape drive hardware compression feature the actual capacity can increase, depending on the effectiveness of compression.

ESTCAPacity

Specifies the estimated capacity for the volumes that are assigned to this device class. This parameter is optional. The default estimated capacity for 3590 tapes is 9 GB.

You can specify this parameter if the default estimated capacity for the device class is inaccurate because of compression of data. The value does not determine the amount of data stored on the volume. The server uses the value to estimate the usage before a volume is filled. After a volume is full, the actual amount of data stored on the tape is used for the usage calculation.

Specify the value as an integer with one of the following unit indicators: K (KB), M (MB), G (GB), or T (TB). For example, specify that the estimated capacity is 9 GB with the parameter ESTCAPACITY=9G. The smallest value that is accepted is 100 KB (ESTCAPACITY=100K).

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, the server 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 a naming convention for media labels to support 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 be a maximum of eight characters including periods. For example, the following value is acceptable:
```
     AB.CD2.E
```
The qualifiers must be separated by a single period.
The first letter of each qualifier must be alphabetic or national (@,#,$), followed by alphabetic, national, hyphen, or numeric characters.

An example of a tape volume data set name using the default prefix is ADSM.BFS.

MOUNTRetention

Specifies the number of minutes that an idle tape volume is retained before it is dismounted. The time span for mount retention begins after the idle timeout period has expired. This parameter is optional. The default value is 60 minutes. Specify a number 0 - 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 that the z/OS media server waits for a volume mount. If the mount request is not satisfied within the specified time, the mount request fails. If a device is successfully allocated and the device-open request does not complete within the specified time, the device-open request ends and the mount request fails.

This parameter is optional. The default value is 60. Specify a number, 1 - 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 2.

If you plan to use the simultaneous-write function, ensure that sufficient drives are available for the write operation. If the number of drives needed for a simultaneous-write operation is greater than the value of the MOUNTLIMIT parameter for a device class, the transaction fails.

Possible values are:

DRIVES: Specifies that every time a mount point is allocated, the number of drives that are defined and online in the library is used to calculate the true value.
number: Specifies the maximum number of drives in this device class that are used concurrently by the server. This value must never exceed the number of drives that are defined and online in the library that services this device class. You can specify a number, 0 - 4096.
0 (zero): Specifies that no new transactions can gain access to the storage pool.

COMPression

Specifies whether file compression is used for this device class. 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.

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.

Specify the date when the server no longer requires the tape. The server does not use this information, but this information is passed to the z/OS media server for use by z/OS or tape management systems.

Specify the expiration date using the format, yyyyddd (four digits for the year and three digits for the day). For example, January 7, 2014 is specified as 2014007 (the seventh day of year 2014).

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

RETention

Specifies the number of days to retain the tape. This parameter is optional.

Specify the number of days (1 - 9999) that the server is expected to use the tape. The server does not use this information, but this information is passed to the z/OS media server for use by z/OS or tape management systems.

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

PROtection

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

No

Specifies that the RACF program does not protect volumes that are assigned to this device class.

Yes

Specifies that the RACF program protects volumes that are assigned to this device class. RACF profiles are created for volumes when the server first uses the volumes, but the profiles are not deleted when volumes are deleted from the server. Profiles must be manually deleted.

Tip: If sensitive data is stored on volumes that are assigned to this device class, use PROTECTION=YES and manually delete RACF profiles only after tape volumes have been erased.

The profiles that are created for volumes depend on the system RACF settings. The protection that is provided is the same as using PROTECT=YES in JCL. If the RACF program is active and both TAPEVOL and TAPEDSN are inactive, allocation of tapes fails.

Automatic

Specifies that the RACF program protects volumes that are assigned to this device class. RACF profiles are created for volumes when the server first uses the volumes. RACF profiles are deleted when volumes are deleted from the server.

Important: If you specify PROTECTION=AUTOMATIC, when a volume is deleted, its RACF profile is deleted. The volume therefore is no longer protected by the RACF program. The data on these volumes can be accessed by other users.

If you specify PROTECTION=AUTOMATIC, the z/OS media server issues RACROUTE commands to delete profiles when a volume is deleted from the server. The deletion commands that are issued depend on the current system settings for TAPEVOL and TAPEDSN. If the system settings are changed, the z/OS media server might not delete existing profiles.

Do not change the setting to PROTECTION=AUTOMATIC for a device class that has been set to PROTECTION=NO. Volumes without profiles might exist and error messages are generated when such volumes are deleted. If a different value for PROTECTION is required, define a new device class.

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

See the documentation for the RACF program for details about the TAPEVOL and TAPEDSN settings and the profiles that are created when these settings are active.

UNIT

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

Feedback