Manuals

task Commands : Dell Command Line Interface Reference Back to Contents Page

task Commands

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]

task list

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.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

task list [/all{=boolean}] [{integer}]

Parameters

{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.

Switches

/all{=boolean}

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:

Windows NT
NetWare
UNIX

Examples

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:

TaskId
Function
Done%
Container
State
Specific1
Specific2

The following sections describe each column that the task list command displays.

The Task ID Column

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

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

Task Type Meaning

Clear A clear container task is running on the specified container. When the clear container task completes, the specified container is cleared. The clear container task runs as a result of using the container clear command. Or, this is a RAID-5 set create task with the clear method specified. The RAID-5 set create task with the clear method specified runs as a result of using the container create raid5 command with the /clear switch.

Create A create mirror set or create multilevel mirror set task is running on the specified container. When the create mirror set or create multilevel mirror set task completes, the specified container is a mirror set or a multilevel container of mirror sets. The create a mirror set or create a multilevel mirror set task runs as a result of using the container create mirror or container create mmirror command.

FATfmt A container format FAT file system task is running on the specified container. The format FAT file system task runs as a result of using the container format command with the /file_system switch set to FAT.

NTFSfmt A container format NTFS file system task is running on the specified container. The format NTFS file system task runs as a result of using the container format command with the /file_system switch set to NTFS.

Rebuild A rebuild task is running on the specified container. Typically, the rebuild task runs when the controller rebuilds a redundant container (RAID-5 set, mirror set, or multilevel container of mirror sets).

Reconfg A container reconfigure task is running on the specified container. When the container reconfigure task completes, the specified container becomes a different container (for example, from a volume set to a stripe set). The container reconfigure task runs as a result of using the container reconfigure command.

Scrub A scrub task is running on the specified redundant container. When the scrub task completes, the specified redundant container has reconstructed data on one partition based on data found on the other partition (for mirror sets and multilevel containers of mirror sets). Or, the specified redundant container recalculates and replaces, if necessary, the parity information (for RAID-5 sets). The scrub task runs as a result of the container scrub command. The scrub task also runs as a result of the container create raid5 command with the /scrub switch specified. This is the task type displayed in the example.

Unknown An unknown task is running.

Verify A verify with no repair of bad blocks task is running on the specified SCSI disk. When the verify with no repair of bad blocks task completes, the specified SCSI disk's blocks were verified without repairing any detected defects. The verify with no repair of bad blocks task runs as a result of using the disk verify command without specifying the /repair switch. Or, a verify with repair of bad blocks task is running on the specified SCSI disk. When the verify with repair of bad blocks task completes, the specified SCSI disk's blocks were verified and any detected bad blocks were repaired. The verify with repair of bad blocks task runs as a result of using the disk verify command with the /repair switch.

Zero A clear disk task is running on the specified SCSI disk. When the clear disk task completes, the specified SCSI disk is cleared (that is, all data is erased and cannot be recovered). The clear disk task runs as a result of using the disk zero command.

The Done% Column

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

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

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

State Meaning

BAD The task failed and is no longer running.

DNE The task successfully completed or the task is no longer running (that is, the task is done).

RUN The task is running.

SUS The task was suspended. Typically, you suspend a task with the task suspend command.

UNK The controller reported an unknown status for the task.

The Specific1 Column

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

Task Additional Information

Verify (Refers to the verify with no repair of bad blocks task, which runs as a result of using the disk verify command without the /repair switch.) Displays the number of bad blocks found with no replacement. The example displays zeroes, which signifies no errors found.

Clear (Refers to the clear container task, which runs as a result of using the container clear command.) Displays the number of bad sectors on a write operation.

Scrub (Refers to the scrub task, which runs as a result of using the container scrub command.) Displays the number of sectors that were different.

The Specific2 Column

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

Task Additional Information

Verify (Refers to the verify with repair of bad blocks task, which runs as a result of using the disk verify command with the /repair switch.) Displays the number of bad blocks found that were replaced.

Related Information

container Commands:

container clear (container clear
container create mirror (container create mirror)
container scrub (container scrub)

disk Commands:

disk verify (disk verify)
disk zero (disk zero)

task Commands:

task resume (task resume)
task stop (task stop)
task suspend (task suspend)

task resume

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.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

task resume [/all{=boolean}] [{integer}]

Parameters

{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.

Switches

/all{=boolean}

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:

Windows NT
NetWare
UNIX

Examples

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:

The State column now displays RUN (the task is running on the controller) instead of SUS (the task is suspended on the controller).

Related Information

task Commands:

task list (task list)
task suspend (task suspend)

task stop

To stop one or all tasks running on the currently opened controller, use the task stop command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

task stop [/all{=boolean}] [{integer}]

Parameters

{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.

Switches

/all{=boolean}

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:

Windows NT
NetWare
UNIX

Examples

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 list
 
 No tasks currently running on controller.

Related Information

task Commands:

task list (task list)

task suspend

To suspend one or all tasks running on the currently opened controller, use the task suspend command.

Command Availability

This command is supported on the following operating systems:

Windows NT
NetWare
UNIX

Syntax

task suspend [/all{=boolean}] [{integer}]

Parameters

{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.

Switches

/all{=boolean}

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:

Windows NT
NetWare
UNIX

Examples

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:

The State column now displays SUS (the task is suspended on the controller) instead of RUN (the task is running on the controller).

Related Information

task Commands:

task list (task list)
task resume (task resume)

Back to Contents Page