Skip to main content

job history show

Contributors
Suggest changes

Display a history of jobs

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

Description

The job history show command displays a history of completed jobs with newer entries displayed first. You can specify optional parameters to select information about job history items that match only those parameters. For example, to display information about jobs that were completed on February 27 at noon, run the command with -endtime "02/27 12:00:00" .

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.

[-node {<nodename>|local}] - Node

Selects the completed jobs that match this parameter value.

[-record <Sequence Number>] - Record ID

Selects the completed jobs that match the record ID or range of record IDs you specify. Note that record IDs are unique for each node, not for the cluster as a whole. As a result, there can be two records with the same record ID within the cluster.

[-vserver <vserver name>] - Owning Vserver

Selects the completed jobs that are owned by the Vserver you specify.

[-id <integer>] - Job ID

Selects the completed jobs that match this parameter value.

[-endtime <MM/DD HH:MM:SS>] - End Time

Selects jobs that completed at the time you specify. This parameter is most useful when used with a range of times.

[-starttime <MM/DD HH:MM:SS>] - Start Time

Selects completed jobs that were started at the time you specify. This parameter is most useful when used with a range of times.

[-name <text>] - Name

Selects the completed jobs that match this parameter value.

[-description <text>] - Description

Selects the completed jobs that match this parameter value.

[-code <integer>] - Status Code

Selects the completed jobs that match this parameter value. Each job defines its own status codes. The completion text is more informative, but support technicians may request this numeric code.

[-progress <text>] - Progress String

Selects the completed jobs that match this parameter value.

[-completion <text>] - Completion String

Selects the completed jobs that match this parameter value.

[-jobuuid <UUID>] - Job UUID (privilege: advanced)

Selects the completed jobs that match this parameter value.

[-event-type {Idle|Running|Succeeded|Failed|Paused|Stopped|Deleted|Error}] - Event Type

Selects the completed jobs that match this parameter value.

[-event-time <MM/DD HH:MM:SS>] - Event Time

Selects the completed jobs that match this parameter value. This parameter is most useful when used with a range of times.

[-error-code <integer>] - Job Manager Error Code

Selects the completed jobs that match this parameter value.

[-error-text <text>] - Job Manager Error Text

Selects the completed jobs that match this parameter value.

[-username <text>] - User Name

Selects the completed jobs that match this parameter value.

Examples

The following example displays information about all completed jobs:

cluster1::> job history show
                              Owning
Time           Node           Vserver    Name                 Event     Job ID
-------------- -------------- ---------- -------------------- --------- ------
08/23 08:58:24 node1          node1-vs   Vol Create           Succeeded     76
     Description: Create testvol
      Completion: Successful
08/23 08:58:22 node1          node1-vs   Vol Create           Running       76
     Description: Create testvol
08/22 08:16:36 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Succeeded      4
     Description: Cluster Backup Job
08/22 08:15:49 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Running        4
     Description: Cluster Backup Job
08/22 08:15:08 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Idle           4
     Description: Cluster Backup Job
08/22 08:15:03 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Running        4
     Description: Cluster Backup Job
6 entries were displayed.

The following example shows how to use a range with the "endtime" parameter to select only the events that ended between 8:15 and 8:16 on August 22nd.

cluster1::> job history show -endtime "08/22 08:15:00".."08/22 08:16:00"
                              Owning
Time           Node           Vserver    Name                 Event     Job ID
-------------- -------------- ---------- -------------------- --------- ------
08/22 08:15:49 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Running        4
     Description: Cluster Backup Job
08/22 08:15:08 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Idle           4
     Description: Cluster Backup Job
08/22 08:15:03 node1          node1-vs   CLUSTER BACKUP AUTO weekly
                                                              Running        4
     Description: Cluster Backup Job
3 entries were displayed.