Dsmcutil valid options

This section lists the valid dsmcutil options that you can specify to use the scheduler service.

About this task

/autostart:[Yes|No]

Specifies whether the Scheduler Service starts automatically at system boot time. The default is No.

/cadschedname:schedulername

Specifies the name of the scheduler service to manage with the client acceptor. Use this option when the managedservices option is set to schedule in the client options file dsm.opt. You can specify this option only with the client acceptor service.

/clientdir:clientdir

The fully qualified directory path where the Client Service files reside. This directory should be relative to the target workstation where the service is installed. UNC names are not allowed if the local system account is set to logon. The default is the current directory.

/clustername:clustername

This option replaces the /group option.

The /clustername option specifies the cluster name to which the system belongs. You can determine the cluster name in any of the following ways:

On MSCS, run the MSCS command, CLUSTER /LIST, from the command line or use the Cluster Administrator utility. When the Cluster Administrator utility starts, it displays a tree-like structure with the cluster name at the top.
On VCS, use the VCS Cluster Manager - Java™ Console or open the main.cf file in the %VCS_HOME%\config directory.
On VCS, use the following command:
```
haclus -display
```

Restriction: Do not specify a clustername of more than 64 characters. If you specify more than 64 characters and you are using Veritas Storage Foundation with High Availability or a Microsoft Cluster Server configuration, you might not be able to install or start the IBM® Storage Protect scheduler service.

This option must be used with the /clusternode:Yes option. This option must be specified when using the INSTALL command in a cluster environment. It must also be specified when using the UPDATE command to modify the cluster settings (/clusternode and /clustername).

This option can also be specified when using the UPDATEPW command in a cluster environment. Normally this is not required. However, if more than one scheduler service with different cluster settings are defined for a particular node, the utility cannot determine which settings are correct. In this case, correct the discrepancies between the services.

Alternatively, you can specify this option with /clusternode:Yes and /force:Yes, to force the utility to show or update the password with the specified cluster settings.

This option is not required if /clusternode:No is specified.

/clusternode:Yes|No

Specifies whether to enable support for cluster resources. The default value is No. You must be running the MSCS or VCS to specify /clusternode:Yes. This option must be specified when using the INSTALL command in a cluster environment. This option must also be specified when using the UPDATE command to modify the cluster settings (/clusternode, /clustername).

Alternatively, you can specify this option with /clustername and /force:Yes, to force the utility to show or update the password with the specified cluster settings. If /clusternode:No is specified, /clustername is not required.

/commmethod:protocol

Specifies client communications protocol to communicate with the IBM Storage Protect server. Valid protocols are: TCP/IP and Named Pipes. If you do not specify a value, the value is obtained from the client options file or set to the default client value. You can also use this option with the UPDATEPW command to specify a communication protocol to connect to a server when updating passwords.

/commport:serverport

Specifies the protocol specific IBM Storage Protect server port. For TCP/IP, this is the port on the specified hostname. If this option is not specified, the value is obtained from the client options file or set to the default client value. You can also use this option with the UPDATEPW command to specify a protocol specific server port to connect to for updating passwords.

/commserver:servername

Specifies the protocol specific IBM Storage Protect server name. Depending on the protocol used, this can be a TCP/IP hostname or a Named Pipes name. If not specified, the value is obtained from the client options file or set to the default client value.

This option can also be used with the UPDATEPW command to specify a protocol specific server name to connect to for updating passwords.

Beginning with IBM Storage Protect server version 8.1.2, when /validate:No is specified, /commserver:servername must also be specified. The servername must match the server name reported by the IBM Storage Protect server command QUERY STATUS. For more information on the QUERY STATUS command, see QUERY STATUS (Query system parameters).

/copyfiles

Specifies that the service installation is copied to another location prior to installing the service. Use the /srcdir option to specify the fully qualified source path.

/errorlog:errorlog

Specifies the fully qualified name of the client error log.

/eventlogging:[Yes|No]

Turns detailed event logging on or off for the specified scheduler service. The default is Yes.

/force:[Yes|No]

This option can also be specified when using the UPDATEPW command in a cluster environment. Normally this is not required. However, if more than one scheduler service with different cluster settings is defined for a particular node, the utility cannot determine which settings are correct. In this case, correct the discrepancies between the services.

Alternatively, you can specify this option with /clusternode and /clustername (if /clusternode:Yes is specified), to force the utility to show or update the password with the specified cluster settings.

/httpport:httpport

Specifies a TCP/IP port address for the web client.

/machine:machinename

Specifies the name of a remote workstation to connect to.

/name:servicename

Specifies the name of the Client service. The name must be quote delimited if it contains embedded spaces.

/node:nodename

Specifies the IBM Storage Protect node name the Client Service uses when connecting to the IBM Storage Protect server. Also used when displaying or updating the IBM Storage Protect password. The default is the workstation name.

/ntaccount:ntaccount

Specifies the Windows account which the service logs in as.

/ntdomain:ntdomain

Specifies the Windows domain which the service logs in as.

/ntpassword:ntpassword

Specifies the Windows password for the account under which the service logs in.

/oldpassword:oldpw

Current IBM Storage Protect server password. Used in conjunction with the /updateonserver option when updating a password on the server.

/optfile:optionsfile

The fully qualified path of the client options file. This is the options file the specified Client Service uses to connect to the IBM Storage Protect server. The utility also uses the file to connect to the IBM Storage Protect server to validate and update passwords. Note that although this option overrides the default option file in the current directory (dsm.opt), the IBM Storage Protect API requires that a default option file exists in the current directory. UNC names are not allowed if the local system account is set to logon. The default is the dsm.opt file in the /clientdir directory.

/partnername:partner service name

This option is used when installing a Remote Client Agent Service to specify the partner Client Acceptor Service.

/password:password

The IBM Storage Protect password which is generated and encrypted.

/schedlog:schedlog

Specifies the fully qualified name of the client schedule log.

/srcdir:pathname

Use this option in conjunction with the /copyfiles option to specify the fully qualified source path to copy the service installation to another location prior to installing the service.

/startnow:[Yes|No]

Specifies whether dsmcutil starts the specified service after executing the command; the default is Yes. If you specify No, you must start the service manually using the services control panel applet, or the NET START name of the service.

/updateonserver:[Yes|No]

Specifies whether the specified password is updated on the IBM Storage Protect server. Requires using the /oldpassword option.

/validate:[Yes|No]

Specifies whether to verify that the node name and password can successfully log in to the IBM Spectrum Protect server. The default is Yes.

/webports: webports

Specifies the TCP/IP port number used by the Client Acceptor service and the web client agent service for communications with the web GUI.