This chapter discusses the task commands listed in Table 1.
Table 1. task Commands
| Command | Summary Description |
|---|---|
| task list | Displays a list of one or all tasks |
| task resume | Resumes one or all tasks |
| task stop | Stops one or all tasks |
| task suspend | Suspends one or all tasks |
Use the following syntax for task commands:
task command [/switch{=value}] [parameter]
To display a list of one or all tasks running on the currently opened controller, use the task list command. A task is an operation that occurs only on the controller, asynchronous to all other operations. Clearing a disk, creating a file system, and creating a mirror set are examples of tasks done on the controller.
The command displays an appropriate message if there are no tasks running on the controller.
This command is supported on the following operating systems:
task list [/all{=boolean}] [{integer}]
Specifies the task ID for the task whose information you want to display. You need to perform a task list /all to display all tasks and their associated IDs.
Specifies whether to display all currently running tasks. If you set this switch to TRUE, the command displays a list of all tasks running on the currently opened controller.
This switch defaults to FALSE if you specify the integer parameter; otherwise, the switch defaults to TRUE.
This switch is supported on the following operating systems:
The following example shows typical output as a result of using the task list command.
AFA0> task list Executing: task list Controller Tasks TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 SUS 00000000 00000000
As the example shows, the typical display shows the following columns of information:
The following sections describe each column that the task list command displays.
The Task ID column displays the ID number associated with a specific task. The controller software assigns each task a unique ID number.
The Function column displays the type of task running on the controller. Table 2 describes the types of tasks that the task list command can display.
Table 2. Task Types
The Done% column displays a running percentage value that indicates the progress of the currently running task. The display shows the percentage in tenths of a percent increments. The currently running task is complete when the Done % column displays 100%.
The Container column displays the ID number of the container associated with the task (if any). In the example, the container's ID is 0 (zero).
The State Column displays the state of the task. Table 3 describes the state values that the task list command can display.
Table 3. State Values
The Specific1 column displays additional information for certain tasks that appear in the Task Id column. Table 4 lists the tasks for which the task list command can display additional information. The table also describes the additional information that task list can display.
Table 4. Additional Specific1 Information
The Specific2 column displays additional information for certain tasks that appear in the Task Id column. Table 5 lists the tasks for which the task list command can display additional information. The table also describes the additional information that task list can display.
The Specific2 column displays information related to the task that appears in the Task Id column. Specifically, the task list command can display the following information in the Specific2 column:
Table 5. Additional Specific2 Information
container clear (container clear
container create mirror (container create mirror)
container scrub (container scrub)
disk verify (disk verify)
disk zero (disk zero)
task resume (task resume)
task stop (task stop)
task suspend (task suspend)
To resume one or all tasks previously suspended on the currently opened controller, use the task resume command. You suspend tasks with the task suspend command.
This command is supported on the following operating systems:
task resume [/all{=boolean}] [{integer}]
Specifies the task ID for the task to resume. Perform a task list /all to display the task IDs for all tasks currently suspended on the open controller before resuming a specific task or all tasks.
Specifies whether to resume all suspended tasks. If you set this switch to TRUE, the command resumes all tasks that were suspended on the currently opened controller.
If you do not specify this switch or a valid task ID, the command displays an appropriate error message.
This switch is supported on the following operating systems:
Before resuming a suspended task, use the task list command to identify any suspended tasks, as in the following example:
AFA0> task list Executing: task list TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 SUS 00000000 00000000
The following example shows the use of the task resume command to resume task 101, which was previously stopped with the task suspend command:
AFA0> task resume 101 Executing: task resume 101
Use the task list command after using the task resume command to display information about the task, as in the following example:
AFA0> task list Executing: task list TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 RUN 00000000 00000000
The following list describes the change in the display as a result of using the task resume command:
RUN (the task is running on the controller) instead of SUS (the task is suspended on the controller).
task list (task list)
task suspend (task suspend)
To stop one or all tasks running on the currently opened controller, use the task stop command.
This command is supported on the following operating systems:
task stop [/all{=boolean}] [{integer}]
Specifies the task ID for the task to stop. Perform a task list /all to display the task IDs for all tasks currently running on the open controller before stopping a specific task or all tasks.
Specifies whether to stop all running tasks. If you set this switch to TRUE, the command stops all tasks that were running on the currently opened controller.
If you do not specify this switch or a valid task ID, the command displays an appropriate error message.
This switch is supported on the following operating systems:
Before stopping a running task, use the task list command to identify any currently running tasks, as in the following example:
AFA0> task list Executing: task list TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 RUN 00000000 00000000
The following example shows the use of the task stop command to stop task 101:
AFA0> task stop 101 Executing: task stop 101
Use the task list command after using the task stop command to display information about the task, as in the following example:
AFA0> task list Executing: task listNo tasks currently running on controller.
task list (task list)
To suspend one or all tasks running on the currently opened controller, use the task suspend command.
This command is supported on the following operating systems:
task suspend [/all{=boolean}] [{integer}]
Specifies the task ID for the task to suspend. Perform a task list /all to display the task IDs for all tasks currently running on the open controller before suspending a specific task or all tasks.
Specifies whether to suspend all running tasks. If you set this switch to TRUE, the command suspends all tasks that were running on the currently opened controller.
If you do not specify this switch or a valid task ID, the command displays an appropriate error message.
This switch is supported on the following operating systems:
Before suspending a running task, use the task list command to identify any currently running tasks, as in the following example:
AFA0> task list Executing: task list TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 RUN 00000000 00000000
The following example shows the use of the task suspend command to suspend task 101:
AFA0> task suspend 101 Executing: task suspend 101
Use the task list command after using the task suspend command to display information about the task, as in the following example:
AFA0> task list Executing: task list TaskId Function Done% Container State Specific1 Specific2 ------ -------- ------- --------- ----- --------- --------- 101 Scrub 24.6% 0 SUS 00000000 00000000
The following list describes the change in the display as a result of using the task suspend command:
SUS (the task is suspended on the controller) instead of RUN (the task is running on the controller).
task list (task list)
task resume (task resume)