z/OS Jobs

In the object workspace, the z/OS jobs are shown when you expand the Jobs folder of a z/OS node. Example:

Jobs folder

This document covers the following topics:


Filtering z/OS Jobs

Before displaying z/OS jobs, you can define a filter so that only those jobs are shown which correspond to your filter criteria.

Start of instruction setTo define a filter

  1. In the object workspace, select the Jobs folder in the appropriate node.

  2. Invoke the context menu and choose Filter.

    Or:
    Press F3.

    The following dialog box appears:

    Filter jobs

  3. Enter the filter criteria.

    Option Description
    Job name Job name on the job card. You can use a combination of strings and wildcards (* and _) to display the jobs matching the job name pattern.
    Class JES job class or output class.
    User ID ID of the user who submitted the job.
    Type If you are only interested in a specific type of job, you can activate one or more of the following check boxes:

    Job (standard operating system job)
    Started task
    TSO user

    When none of these check boxes is selected, all information is always shown.

    Queue If you are only interested in specific queues, you can activate up to four check boxes for the JES queue type:
    Executing Executing queue.
    Input Input queue (held and non-held jobs).
    Output Output queue.
    Hold Output queue jobs on hold.
    Waiting Input queue jobs on hold.
    When none of these check boxes is selected, the information from all queues is always shown.
  4. Choose the OK button.

Listing z/OS Jobs

The number of objects shown in the list view window depends on whether or not a filter has been defined for the z/OS jobs (see Filtering z/OS Jobs).

Start of instruction setTo list z/OS jobs

  1. In the object workspace, select the Jobs folder in the appropriate node.

  2. Invoke the context menu and choose List.

    Or:
    Press F8.

    A list of jobs is shown in the list view window. Example:

    List jobs

    The list contains the following columns:

    Column Description
    Job Name Name of the job.
    Number JES job number.
    Type Type of job. Possible values:
    JOB Standard operating system job.
    STC Started task.
    TSO TSO user.
    Queue JES queue type. Possible values:
    H Output queue jobs on hold.
    I Input queue (held and non-held jobs).
    O Output queue.
    X Executing queue.
    Class JES job class (when the queue type is I or X) or output class (when the queue type is O or H).
    Priority JES priority within the current queue.
    Destination JES printout destination name.
    Status Job status (can be AVAIL or HOLD).
    Owner ID of the user who submitted the job.
    Step Name of the step currently executed (only when the job is active).
    Procedure Name of the procedure currently executed (only when the job is active).
    CPU CPU time in minutes consumed by the address space (only when the job is active).
    Region Amount of real storage used by the address space in Kbytes (only when the job is active).
    IO Number of I/Os performed so far (only when the job is active).
    Records Total number of records in job sysout files.
    Start Date Date when job execution started.
    Time Time when job execution started.
    End Date Date when job execution ended.
    Time Time when job execution ended.
    System ID System in which the job executes in a Sysplex environment.

Displaying the Condition Codes of a z/OS Job

When you display the condition codes of a job, they are shown in a browse window.

Start of instruction setTo display the condition codes of a z/OS job

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Condition Codes.

    Or:
    Press CTRL+ALT+C.

    A browse window similar to the following appears in the content pane.

    Condition codes

    See also Commands for Browsing an Object.

Displaying the Status of a z/OS Job

You can check whether a job is executing or whether it is in the input queue or output queue.

Start of instruction setTo display the status of a z/OS job

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Status.

    Or:
    Press CTRL+F10.

    The job status is displayed in a dialog box in the content pane. Example:

    Job status

  3. Choose the OK button to close the dialog box.

Putting a z/OS Job on Hold

You can put the sysout of a job on hold.

Start of instruction setTo put a z/OS job on hold

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Hold.

    All job sysout is put on hold.

Releasing a z/OS Job from Hold

When the sysout of a job has been put on hold, you can release it from hold.

Start of instruction setTo release a z/OS job from hold

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Release.

    All job sysout is released from hold.

Changing the Attributes of a z/OS Job

You can change the class and/or destination of a z/OS job.

Start of instruction setTo change the attributes of a z/OS job

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Change.

    The following dialog box appears:

    Change job

  3. Enter the new attributes.

  4. Choose the OK button.

Turning on Follow Mode for a z/OS Job

You can instruct Mainframe Navigation to display a message when the job has terminated.

Follow mode can be active for one job only. If it is activated for a second job before the first job has terminated, only the second job will be followed.

Start of instruction setTo turn on follow mode for a z/OS job

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Follow.

Turning off Follow Mode for a z/OS Job

When you turn off follow mode, a message is no longer displayed.

Start of instruction setTo turn off follow mode for a z/OS job

  1. Select a job in the object workspace or list view window.

  2. Invoke the context menu and choose Follow Off.