Skip to main content

job show

Contributors
Suggest changes
PDFs

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.