![]() |
![]() |
An administrator can create a set of client options to be used by a client node at Tivoli Storage Manager Version 3 or later. The client options specified in the set are used in conjunction with the client options file described in Connecting Nodes with the Server.
Client option sets allow the administrator to specify additional options that may not be included in the client's option file (dsm.opt). You can specify which clients use the option set with the REGISTER NODE or UPDATE NODE commands. The client can use these defined options during a backup, archive, restore, or retrieve process. See Backup-Archive Installation and User's Guide for detailed information about individual client options.
To create a client option set and have the clients use the option set, do the following:
When you create a client option set, you define a name for the option set, and can optionally provide a description of the option set. For example:
define cloptset engbackup description='Backup options for eng. dept.'
You can add client options in a defined client option set.
The following example shows how to add a client option in the ENGBACKUP option set.
define clientopt engbackup schedlogretention 5
For a list of valid client options you can specify, refer to Administrator's Reference.
The server automatically assigns sequence numbers to the specified options, or you can choose to specify the sequence number for order of processing. This is helpful if you have defined more than one of the same option as in the following example.
define clientopt engbackup inclexcl "include d:\admin" define clientopt engbackup inclexcl "include d:\payroll"
A sequence number of 0 is assigned to the option include d:\admin. A sequence number of 1 is assigned to the option include d:\payroll. If you want to specifically process one option before another, include the sequence parameter as follows:
define clientopt engbackup inclexcl "include d:\admin" seqnumber=2" define clientopt engbackup inclexcl "include d:\payroll" seqnumber=1"
The options are processed starting with the highest sequence number.
Any include-exclude statements in the server client option set have priority over the include-exclude statements in the local client options file. The server include-exclude statements are always enforced and placed at the bottom of the include-exclude list and evaluated before the client include-exclude statements. If the server option set has several include-exclude statements, the statements are processed starting with the highest sequence number. The client can use the QUERY INCLEXCL command to view the include-exclude statements in the order they are processed. QUERY INCLEXCL also displays the source of each include-exclude statement. For more information on the processing of the include-exclude statements see The Include-Exclude List and also the Backup-Archive Installation and User's Guide.
The FORCE parameter allows an administrator to specify whether a client node can override an option value. This parameter has no effect on additive options such as INCLEXCL and DOMAIN. The default value is NO. If FORCE=YES, the client cannot override the value. The following example shows how you can prevent a client from using subfile backup:
define clientopt engbackup subfilebackup no force=yes
You can register or update a client node and specify an option set for the client to use as follows:
register node mike pass2eng cloptset=engbackup
The client node MIKE is registered with the password pass2eng. When the client node MIKE performs a scheduling operation, his schedule log entries are kept for 5 days.