DEFINE DEVCLASS (Define a SERVER device class)

Use the SERVER device class to use storage volumes or files that are archived in another Tivoli® Storage Manager server.

If data retention protection is activated with the SET ARCHIVERETENTIONPROTECTION command, you cannot define a server device class.

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--=--size-'   

   .-MOUNTLimit--=--1------.  .-MOUNTRetention--=--60------.   
>--+-----------------------+--+----------------------------+---->
   '-MOUNTLimit--=--number-'  '-MOUNTRetention--=--minutes-'   

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

   .-RETRYPeriod--=--10--------------------.   
>--+---------------------------------------+-------------------->
   '-RETRYPeriod--=--retry_value_(minutes)-'   

   .-RETRYInterval--=--30--------------------.   
>--+-----------------------------------------+-----------------><
   '-RETRYInterval--=--retry_value_(seconds)-'

Parameters

device_class_name (Required)

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

DEVType=SERVER (Required)

Specifies a remote connection that supports virtual volumes.

SERVERName (Required)

Specifies the name of the server. The SERVERNAME parameter must match a defined server.

MAXCAPacity

Specifies the maximum size for objects that are created on the target server; the default for this value is 500M. This parameter is optional.

500M: Specifies that the maximum capacity is 500M (500 MB).
size: Specify this value as an integer followed by K (kilobytes), M (megabytes), G (gigabytes), or T (terabytes). The minimum value that is allowed is 1 MB (MAXCAPACITY=1M).

MOUNTLimit

Specifies the maximum number of simultaneous sessions between the source server and the target server. Any attempts to access more sessions than indicated by the mount limit cause the requester to wait. This parameter is optional. The default value is 1. You can specify a number 1 - 4096.

The following are possible values:

1: Specifies that only one session between the source server and the target server is allowed.
number: Specifies the number of simultaneous sessions between the source server and the target server.

MOUNTRetention

Specifies the number of minutes to retain an idle connection with the target server before the connection closes. This parameter is optional. The default value is 60. You can specify a number 0 - 9999.

Note: For environments in which devices are shared across storage applications, the MOUNTRETENTION setting must be carefully considered. This parameter determines how long an idle volume remains in a drive. Some media managers do not dismount an allocated drive to satisfy pending requests. You might need to tune this parameter to satisfy competing mount requests while maintaining optimal system performance. Typically, problems arise more frequently when the MOUNTRETENTION parameter is set to a value that is too small, for example, zero.

PREFIX

Specifies the beginning portion of the high-level archive file name on the target server. This parameter is optional. The default 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 that are 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 high-level archive file name that uses the default prefix 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. You can specify a number 0 - 9999. The default value is 10 minutes.

RETRYInterval

Specifies the retry interval in seconds. The retry interval is how often retries are done within a specific time period. This parameter is optional. You can specify a number 1 - 9999. The default value is 30 seconds.