job listtasks
Lists information about the tasks that belong to the specified job.
For examples of how to use this command, see Examples.
Syntax
job listtasks <jobID> [/expand] [/format:{list|table}]
[/scheduler:<name>] {[/state:<state1>[,<state2>…]] |
[/status:<status1>[,<status2>…]]}
job listtasks {/? | /help}
Parameters
| Parameter | Description |
|---|---|
| jobID | Specifies the identifier of the job for which you want to display task information. |
| /expand | Expands the information that is displayed for parametric tasks, listing each subtask of the parametric task instead of the overall parametric task. |
| /format:{list|table} | Specifies the format in which the command should display the information. The valid formats are list and table. The default format is list. The table format is useful when the job contains many tasks or subtasks. |
| /scheduler:<name> | Specifies the host name or IP address of the head node for the cluster that contains the job for which you want to view the tasks. The value must be a valid computer name or IP address. If you do not specify the /scheduler parameter, this command uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. |
| /state:<state1>[,<state2>…] | Specifies a list of one or more states for the tasks for which you want to display information. If you specify multiple states, separate them by commas (,), or use a value of All to specify all of the states. The possible states are Configuring, Submitted, Running, Finished, Failed, and All. |
| /status:<status1>[,<status2>…] | Specifies a list of one or more status values for the jobs for which you want to display information. If you specify multiple status values, separate them by commas (,), or use a value of All to specify all of the status values. The possible status values are Configuring, Submitted, Running, Finished, Failed, and All. Note: This parameter is deprecated. Use the /state parameter instead. |
| /? | Displays Help at the command prompt. |
| /help | Displays Help at the command prompt. |
Examples
To view information about all of the tasks in the job with an identifier of 35, use the following command:
job listtasks 35
To view information about all the tasks or subtasks that failed for the job with an identifier of 42, with the parametric tasks expanded to display the subtasks, use the following command:
job listtasks 42 /expand /state:failed