jobs

This command lists the running queued or historical jobs.

Syntax

zos jobs [--all] [--detail] [--errors] [--submit=] [--hours=] [--active] [--count=] [--parent=]

Options

-a, --all

Lists all users’ jobs, not just the logged in user’s jobs.

-e, --detail

Displays detailed job information for each job.

-E, --errors

Displays details of job and node errors.

-s, --submit=<value>

Specifies a time when the user wants to see historical jobs. The user must enter a value with this option.

-h, --hours=<value>

Specifies submit time in the form of last xxx hours. If specified, this option overrides the submit option. The user must enter a value with this option.

-A, --active

Lists only the currently active or running jobs.

-c, --count=<value>

Sets the maximum number of historical jobs retrieved. The user must enter a value with this option.

-p, --parent=<value>

Specifies the parent job id. If this option is set, only the child jobs of this parent are displayed. The user must enter a value with this option.

-C, --cols=<value>

Specifies the terminal width for formatting. The user must enter a value with this option.

-h, --help

Displays a help message for this operation.

-d, --debug

Turns on debug output during this operation.

-v, --verbose

Turns on verbose output during this operation.

-z, --tls=<value>

Force TLS/SSL encryption [on|off]. The user must enter a value with this option.

-Z, --tlsPort=<value>

Port number for TLS/SSL connections. The user must enter a value with this option.

-y, --tlsYesNew

Force acceptance of new TLS server certificates.

-Y, --tlsYesAll

Force acceptance of all TLS server certificates.

Examples

Example 1

To display a detailed list of running jobs for all users, the user would enter the following command:

zos jobs -a -e

Example 2

To display a list of queued, running, and recently run jobs, the user would enter the following command:

zos jobs

Example 3

To display a list of jobs he or she submitted since 2:20 p.m., the user would enter the following command:

zos jobs --submit="2:20 PM"

NOTE:The date and time values should be specified as shown in the example—in the format MM/DD/YY hour:minute AM/PM and enclosed in quotes—"11/21/05 4:04 PM".

Example 4

To display a list of all active subjobs for the jobid barney.load.677, the user would enter the following command:

zos jobs -A --parent=barney.load.677 --all

Example 5

To display a list of all his or her jobs run in the past 24 hours, the user would enter the following command:

zos jobs -h 24