CmsConfig setopt command

Edit online

Use the CmsConfig setopt command to set the path of the client options file (typically dsm.opt) to an existing node definition without first reading the contents of the client options file.

This command can be helpful if the client options file does not have a typical name or is in a non-default location.

Requirement: If the node definition does not exist, you must first issue the CmsConfig addnode command to create the node definition.

Unlike the CmsConfig discover command, the CmsConfig setopt command does not create associated log definitions in the client-configuration.xml file. You must use the CmsComfog addlog command to create the log definitions.

Syntax

Parameters

nodeName

The client node name that is associated with the log files. For most client systems, only one node name is registered to the IBM Storage Protect server. However, on systems with multiple users, such as Linux® client systems, there can be more than one client node name. This parameter is required.

optPath

The fully qualified path of the client options file. This parameter is required.

Example (Linux client): /opt/backup_tools/tivoli/tsm/baclient/dsm.opt

Example (Windows client): C:\backup tools\Tivoli\TSM\baclient\dsm.opt

Example for a Linux client system

Set the client options file path for the node SUSAN. The path for the client options file is /opt/tivoli/tsm/client/ba/bin/dsm.opt.

Issue the following command from the /opt/tivoli/tsm/cms/bin directory.

Command:

./CmsConfig.sh setopt SUSAN /opt/tivoli/tsm/client/ba/bin/dsm.opt

Output:


Adding node configuration file.

Finished adding client configuration file.

Example for a Windows client system

Set the client options file path for the node SUSAN. The path for the client options file is c:\program files\tivoli\tsm\baclient\dsm.opt.

Issue the following command from the C:\Program Files\Tivoli\TSM\cms\bin directory.

Command:

cmsconfig setopt SUSAN "c:\program files\tivoli\tsm\baclient\dsm.opt"

Output:


Adding node configuration file.

Finished adding client configuration file.