Display a list of cluster jobs
Availability: This command is available to cluster and Vserver administrators at the admin privilege level.
Description
The
job show-cluster command
displays information about cluster-affiliated jobs. The command
output depends on the parameters specified with the
command. If no parameters are specified, the command displays
information about all cluster-affiliated jobs.
To display detailed information about a specific job, run the
command with the -id parameter.
The detailed view includes all of the default information
plus additional items.
You can specify additional parameters
to display only information that matches
the values you specify for those parameters.
For example, to display information only about jobs
running on a specific node, run the command with the
-node parameter.
Parameters
- { [-fields <fieldname>, ...]
- If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
- | [-instance ]}
- If you specify the -instance parameter, the command displays detailed information about all fields.
- [-id <integer>] - Job ID
- Use this parameter to display information only about
the jobs that match the ID or range of IDs you specify.
- [-vserver <vserver name>] - Owning Vserver
- Use this parameter with the name of a Vserver
to display only jobs that are owned by that Vserver.
- [-name <text>] - Name
- Use this parameter to display information only about
the jobs that match the job name you specify.
- [-description <text>] - Description
- Use this parameter to display information only about
the jobs that match the description you specify.
- [-priority {Low|Medium|High|Exclusive}] - Priority
- Use this parameter to display information only about
the jobs that match the priority you specify.
- [-node <nodename>] - Node
- Use this parameter to display information only about
the jobs that are associated with the node you specify.
- [-affinity {Cluster|Node}] - Affinity
- Use this parameter with an affinity value to display only
jobs that match the affinity you specify.
- [-schedule <job_schedule>] - Schedule
- Use this parameter to display information only about
the jobs that run on the schedule you specify.
- [-queuetime <MM/DD HH:MM:SS>] - Queue Time
- Use this parameter to display information only about
the jobs that match the queue time you specify.
- [-starttime <MM/DD HH:MM:SS>] - Start Time
- Use this parameter to display information only about
the jobs that match the start time you specify.
- [-endtime <MM/DD HH:MM:SS>] - End Time
- Use this parameter to display information only about
the jobs that match the end time you specify.
- [-dropdeadtime <MM/DD HH:MM:SS>] - Drop-dead Time
- Use this parameter to display information only about
the jobs that match the final timeout time you specify.
- [-restarted {true|false}] - Restarted?
- Use this parameter to display information only about
the jobs that match the restart value you specify.
- [-state {Initial|Queued|Running|Waiting|Pausing|Paused|Quitting|Success|Failure|Reschedule|Error|Quit|Dead|Unknown|Restart|Dormant}] - State
- Use this parameter to display information only about
the jobs that match the job state you specify.
- [-code <integer>] - Status Code
- Use this parameter to display information only about
the jobs that match the status code you specify.
- [-completion <text>] - Completion String
- Use this parameter to display information only about
the jobs that match the completion text you specify.
- [-jobtype <text>] - Job Type
- Use this parameter to display information only about
the jobs that match the job type you specify.
- [-category <text>] - Job Category
- Use this parameter to display information only about
the jobs that match the job category you specify.
- [-uuid <UUID>] - UUID
- Use this parameter to display information only about
the jobs that match the UUID you specify.
- [-username <text>] - User Name
- Use this parameter with a username
to display only jobs that are associated with
the user you specify.
Examples
The following example displays information about all cluster-affiliated jobs:
cluster1::> job show-cluster
Owning
Job ID Name Vserver Node State
------ ---------------- --------- -------------- -----------
305 Auto_Mirror node-vserver
- Running
6202 mirror-03_10 node-vserver
- Queued
Descr:Auto mirror
6203 mirror-04_10 node-vserver
- Queued
Descr:Auto mirror
6204 mirror-01_10 node-vserver
- Queued
Descr:Auto mirror
6205 mirror-02_10 node-vserver
- Queued
Descr:Auto mirror
6206 mirror-05_10 node-vserver
- Queued
Descr:Auto mirror