Skip to main content

job show-cluster

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