Siebel System Administration Guide > Using the Siebel Server Manager Command-Line Interface > Siebel Server Manager Commands >

Task Management Commands

Use task management commands to manage tasks for components running in batch or background mode.

You may start a new process by using the start task command or the run task command. You should use the start task command if you plan to start multiple processes and the run task command if you want to make sure that a process has run to completion.

Start task. The start task command starts a new process and allows you to execute a new command immediately. You will not be notified of the task status, nor will you be alerted if the task fails to perform. Instead, use the list task command to check the status of processes that were started using the start task command.

Run task. The run task command starts a new process that runs to completion (or exits with error). You will not be able to execute a new command until the process has run to completion. The task status will be displayed as the process is running.

To use multiple task parameters in a task command, list the parameters in a comma-separated list. The following example shows how to start a new process using various values for a given parameter:

start {task | server} for component component_alias_name with parameter_alias_name=value1, value2, value3

To start a new task in batch mode

• Enter:

  start task for component component_alias_name server siebel_server_name with parameter_alias_name1=value1, parameter_alias_name2=value2

  This command starts a new task in batch mode and returns to the Siebel Server Manager immediately.

To start a new task in background mode

• Enter:

  start server for component component_alias_name server siebel_server_name with parameter_alias_name1=value1, parameter_alias_name2=value2

  This command starts a new task in background mode and returns to the Siebel Server Manager immediately.

To run a new task in batch mode

• Enter:

  run task for component component_alias_name server siebel_server_name with parameter_alias_name1=value1, parameter_alias_name2=value2

  This command runs a new task in batch mode to completion before returning to the Siebel Server Manager.

To pause a running task

• Enter:

  pause task Task ID for server siebel_server_name

  NOTE:  Only tasks from certain component types can be paused. See Table 15 for a list of these component types.

To resume a paused task

• Enter:

  resume task Task ID for server siebel_server_name

To stop a running task

• Enter:

  stop task Task ID for server siebel_server_name

To kill a running task

• Enter:

  kill task Task ID for server siebel_server_name

  The Kill Task command signals the Siebel Server to use operating system control to terminate the task. This command replicates the GUI procedure of selecting Stop Task from the menu button three times in succession on a running task.