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 from 1 to 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 from 0
to 9999.
- 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:
- 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 from 0 to 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 from 1 to 9999.
The default value is 30 seconds.