Run service (optimcmd -run)

Use the Run service command to run a service by using the server to which the service is assigned. You can optionally specify an override file that contains input values for the service. If you specify an override file, the service is run by using the input values that are specified in the override file.

Command structure

The following diagram indicates the structure of the command and its parameters.

Read syntax diagramSkip visual syntax diagram
>>-optimcmd--+- -run-+--+-connection=-+--connection_name--serviceid-->
             '- -r---'  '-cn=---------'                               

>--+---------------------------------+--+-------------------+--><
   '-+-overridefile=-+--overridefile-'  '-+-user=-+--userid-'   
     '-ov=-----------'                    '-u=----'             

Input

The following information can be entered with the command.

optimcmd
The optimcmd tool.
-run or -r
The Run service command.
connection=connection_name or cn=connection_name
The connection name of the Optim™ directory in which the service is located.
serviceid
The service ID for the service that you want to run.
overridefile=overridefile or ov=overridefile
The name and path of the override file that contains the input values that you want to use to run the service. The override file that is used by the Run service command is a text file. Each line in the override file contains a parameter or override name, an equals sign, and the value to use for the parameter or override. The override file must be on the Optim server that is running the service.
-user=userid or -uuserid
The user ID to use to run the service.

Output

When successful, the command returns the execution ID of the service instance that is started when you run the service.



Feedback