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.
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.
Give documentation feedback