An administrator can create a set of client options to be used by a client node at TSM 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 options sets allow the administrator to specify additional options that may not be included in the client's option file (dsm.opt). Specify 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 Tivoli Storage Manager Installing the Clients 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 sequence=2" define clientopt engbackup inclexcl "include d:\payroll sequence=1"
The FORCE parameter allows an administrator to specify whether a client node can override an option value. The default value is NO. If FORCE=YES, the client cannot override the value.
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.