Skip to main content

job show-completed

Contributors
Suggest changes

Display a list of completed jobs

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

Description

The job show-completed command displays information about completed jobs. The command output depends on the parameters you specify with the command. If you do not use any parameters, the command displays information about all completed jobs.

To display detailed information about a specific job, run the command with the -id parameter. The detailed view includes all of the default information plus additional items.

You can specify additional parameters to display only information that matches those parameters. For instance, 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.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-id <integer>] - Job ID

Use this parameter to display information only about the jobs that match the ID or range of IDs you specify.

[-vserver <vserver name>] - Owning Vserver

Use this parameter with the name of a Vserver to display only jobs that are owned by that Vserver.

[-name <text>] - Name

Use this parameter to display information only about the jobs that match the name you specify.

[-description <text>] - Description

Use this parameter to display information only about the jobs that match the description you specify.

[-priority {Low|Medium|High|Exclusive}] - Priority

Use this parameter to display information only about the jobs that match the priority you specify.

[-node <nodename>] - Node

Use this parameter to display information only about the jobs that are associated with the node you specify.

[-affinity {Cluster|Node}] - Affinity

Use this parameter with an affinity value to display only jobs that match the affinity you specify.

[-schedule <job_schedule>] - Schedule

If you use this parameter, the command displays information only about the jobs that have the schedule you specify.

[-queuetime <MM/DD HH:MM:SS>] - Queue Time

If you use this parameter, the command displays information only about the jobs that have the queue time you specify.

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

Use this parameter to display information only about the jobs that have the start time you specify.

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

Use this parameter to display information only about the jobs that have the end time you specify.

[-dropdeadtime <MM/DD HH:MM:SS>] - Drop-dead Time

Use this parameter to display information only about the jobs that time out at the time you specify.

[-restarted {true|false}] - Restarted?

Use this parameter to display information only about the jobs that match the restart value you specify.

[-state {Initial|Queued|Running|Waiting|Pausing|Paused|Quitting|Success|Failure|Reschedule|Error|Quit|Dead|Unknown|Restart|Dormant}] - State

Use this parameter to display information only about the jobs that match the job state you specify.

[-code <integer>] - Status Code

Use this parameter to display information only about the jobs that match the status code you specify.

[-completion <text>] - Completion String

Use this parameter to display information only about the jobs that match the completion text you specify.

[-jobtype <text>] - Job Type

Use this parameter to display information only about the jobs that match the job type you specify.

[-category <text>] - Job Category

Use this parameter to display information only about the jobs that match the job category you specify.

[-uuid <UUID>] - UUID

Use this parameter to display information only about the jobs that match the UUID you specify.

[-username <text>] - User Name

Use this parameter with a username to display only jobs that are associated with that user.

Examples

The following example displays information about all completed jobs:

node::> job show-completed
                       Owning
Job ID Name            Vserver  End Time       Code       Completion String
------ --------------- -------- -------------- ---------- --------------------
305     Auto_Mirror    node-vserver
                                10/10 08:07:05 0          Succeeded
6202    mirror-03_10   node-vserver
                                10/10 11:10:07 0
6203    mirror-04_10   node-vserver
                                10/10 12:10:09 0
6204    mirror-01_10   node-vserver
                                10/10 09:10:03 0
6205    mirror-02_10   node-vserver
                                10/10 10:10:08 0
6206    mirror-05_10   node-vserver
                                10/10 05:10:04 0