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 can start a new process by using the start task command or the run task command. Use the start task command if you plan to start multiple processes and use the run task command if you want to make sure that a process has run to completion.

The following are the two task management commands:

• Start task. The start task command starts a new process and allows you to execute a new command immediately. You are not notified of the task status, nor are you alerted if the task fails to perform. Instead, use the list task command to check the status of processes that were started by using the start task command.
• Run task. The run task command starts a new process that runs to completion (or exits with an error). You cannot execute a new command until the process has run to completion. The task status is 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 the following command:

  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 the following command:

  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 the following command:

  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 the following command:

  pause task task_ID for server siebel_server_name

  NOTE:  Only tasks from certain component types can be paused. For a list of these component types, see Table 21.

To resume a paused task

• Enter the following command:

  resume task task_ID for server siebel_server_name

To stop a running task

• Enter the following command:

  stop task task_ID for server siebel_server_name

To terminate a running task using the kill command

• Enter the following command:

  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 clicking Menu and then Stop Task three times in succession on a running task.