job history show

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.