UPDATE DEVCLASS (Update a SERVER device class)

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

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

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

>--+-----------------------------+------------------------------>
   '-RETRYPeriod--=----minutes---'   

>--+-------------------------------+---------------------------->
   '-RETRYInterval--=----seconds---'   

>--+----------------------------+------------------------------->
   '-MOUNTRetention--=--minutes-'   

>--+---------------------------+-------------------------------><
   '-MOUNTLimit--=--+-number-+-'   
                    '-1------'

Parameters

device_class_name (Required)

Specifies the name of the device class to be updated.

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 is no longer accessible with this device class.

MAXCAPacity

Specifies the maximum size that objects can be when created on the target server. This parameter is optional.

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

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.

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.

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.

MOUNTRetention

Specifies the number of minutes to retain an idle connection with the target server before the connection is closed. This parameter is optional. 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.

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. You can specify a number 1 - 4096.

The following are possible values:

number: Specifies the maximum number of simultaneous sessions between the source server and the target server.
1: Specifies the number of simultaneous sessions between the source server and the target server.