z/VSE Jobs

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

Power-Jobs folder

This document covers the following topics:


Filtering z/VSE Jobs

Before displaying z/VSE 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 Power-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 Installation-specific job class. Combinations are possible to display a list of jobs of several classes.
    User ID You can restrict the displayed jobs by specifying a user ID. You can use the asterisk (*) as a wildcard. Only the jobs submitted by the specified user(s) are then displayed..
    Destination You can restrict the displayed jobs by specifying a destination. You can use the asterik (*) as a wildcard. Only the jobs for the specified destination(s) are then displayed.
    System ID You can restrict the displayed jobs by specifying a system ID. You can use the asterisk (*) as a wildcard. Only the jobs under the specified system(s) are then displayed.
    Queue Job entry system queue. You can activate the check boxes for the following types of queues:

    Reader
    List
    Punch
    Transmit

    Disposition How job is handled in a Reader queue. You can activate the check boxes for the following types of dispositions:

    Active
    Delete (delete after processing; job starts automatically)
    Hold (hold job; must be started explicitly)
    Leave (leave in queue after processing; must be started explicitly)
    Keep (keep after processing; starts automatically as Delete; after run, disposition is Leave)

  4. Choose the OK button.

Listing z/VSE Jobs

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

Start of instruction setTo list z/VSE jobs

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

  2. Invoke the context menu and choose List.

    Or:
    Press F8.

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

    List jobs

    List jobs

    The list contains the following columns:

    Column Description
    Job Name Job name on the job card.
    Number Job number assigned. Only the combination of job name and number uniquely identifies a submitted job (if more than one copy of the same job is in the queues).
    Queue Job entry system queue. Possible options:
    L List queue.
    P Punch queue.
    R Reader queue.
    X Transmit queue.
    Segment Number of output datasets, if segmented.
    Class Installation-specific job class.
    Disposition How the job is handled in the R queue. Possible options:
    * Active.
    D Delete after processing (job starts automatically).
    H Hold job (must be started explicitly).
    K Keep after processing. Starts automatically as D. After the run, the disposition is L.
    L Leave in queue after processing (must be started explicitly).
    Priority Job priority.
    Status Job status.
    From Owner of the job, that is, the user who issued Submit.
    To Destination of job.
    Copies Number of copies of the job.
    Pages Number of pages of the job.
    Records Number of records of the job.
    Partition Partition ID.
    CPU CPU time consumed in minutes.
    IO Number of I/O operations performed so far.
    Step Name of step currently being executed.
    Procedure Name of procedure currently being executed.
    Region Real storage used by address space in Kbytes.

Displaying the Condition Codes of a z/VSE 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/VSE 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/VSE Job

You can check whether a job is executing or whether it is in one of the following queues: reader queue, list queue, punch queue or transmit queue.

Start of instruction setTo display the status of a z/VSE 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/VSE Job on Hold

You can put a job on hold.

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

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

  2. Invoke the context menu and choose Hold.

    The job is put on hold.

Releasing a z/VSE Job from Hold

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

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

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

  2. Invoke the context menu and choose Release.

    The job is released from hold.

Changing the Attributes of a z/VSE Job

You can change, for example, the class and/or destination of a z/VSE job.

Start of instruction setTo change attributes of a z/VSE 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/VSE 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/VSE 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/VSE Job

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

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

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

  2. Invoke the context menu and choose Follow Off.