Skip to main content

job show

Display a list of jobs

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The job show command displays information about jobs. By default, the command displays information about all current jobs.

To display detailed information about a specific job, run the command with the -id parameter.

You can specify additional parameters to select 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.
| [-inprogress ]
Displays the job ID, the job name, the owning Vserver, and the progress of the job.
| [-jobstate ]
Displays information about each job's state, including the queue state, whether the job was restarted, and when the job has completely timed out.
| [-sched ]
Displays the job ID, the job name, the owning Vserver, and the schedule on which the job runs.
| [-times ]
Displays the job ID, the job name, the owning Vserver, the time when the job was last queued, the time when the job was last started, and the time when the job most recently ended.
| [-type ]
Displays the job ID, the job name, the job type, and the job category.
| [-jobuuid ] (privilege: advanced)
Displays the job ID, the job name, the owning Vserver, and the job UUID.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-id <integer>] - Job ID
Selects the jobs that match the ID or range of IDs that you specify.
[-vserver <vserver name>] - Owning Vserver
Selects jobs that are owned by the specified Vserver.
[-name <text>] - Name
Selects the jobs that match this parameter value.
[-description <text>] - Description
Selects the jobs that match this parameter value.
[-priority {Low|Medium|High|Exclusive}] - Priority
Selects the jobs that match this parameter value.
[-node <nodename>] - Node
Selects the jobs that match this parameter value.
[-affinity {Cluster|Node}] - Affinity
Selects the jobs that match this parameter value.
[-schedule <job_schedule>] - Schedule
Selects the jobs that match this parameter value.
[-queuetime <MM/DD HH:MM:SS>] - Queue Time
Selects the jobs that match this parameter value.
[-starttime <MM/DD HH:MM:SS>] - Start Time
Selects the jobs that match this parameter value.
[-endtime <MM/DD HH:MM:SS>] - End Time
Selects the jobs that match this parameter value.
[-dropdeadtime <MM/DD HH:MM:SS>] - Drop-dead Time
Selects the jobs that match this parameter value.
[-restarted {true|false}] - Restarted?
Selects the jobs that match this parameter value.
[-state {Initial|Queued|Running|Waiting|Pausing|Paused|Quitting|Success|Failure|Reschedule|Error|Quit|Dead|Unknown|Restart|Dormant}] - State
Selects the jobs that match this parameter value.
[-code <integer>] - Status Code
Selects the jobs that match this parameter value.
[-completion <text>] - Completion String
Selects the jobs that match this parameter value.
[-jobtype <text>] - Job Type
Selects the jobs that match this parameter value.
[-category <text>] - Job Category
Selects the jobs that match this parameter value.
[-uuid <UUID>] - UUID (privilege: advanced)
Selects the jobs that match this parameter value.
[-progress <text>] - Execution Progress
Selects the jobs that match this parameter value.
[-username <text>] - User Name
Selects the jobs that match this parameter value.
[-restart-is-delayed-by-module <text>] - Restart Is Delayed by Module
Selects jobs which are or were delayed by the specified module during the restart. For example: MCC_SWITCHBACK

Examples

The following example displays information about all jobs on the node named node1:

cluster1::> job show -node node1
Owning
Job ID Name Vserver Node State
------ ---------------- --------- ------------ ----------
308114 mirror-daily-3587206
node-vserver
node1 Running
Descr:Auto-replicate to 1 mirror(s)
308115 mirror-daily-3618985
node-vserver
node1 Running
Descr:Auto-replicate to 1 mirror(s)
308116 mirror-daily-3619010
node-vserver
node1 Queued
Descr:Auto-replicate to 1 mirror(s)
308117 mirror-daily-3749547
node-vserver
node1 Queued
Descr:Auto-replicate to 1 mirror(s)
4 entries were displayed.