End-of-Job Checking and Actions Screen

This document covers the following topics:


Invoking End-of-Job Checking and Actions

Start of instruction set To invoke the End-of-Job Checking and Actions facility, display the Job Maintenance screen.

  1. Type O in the line command field of the selected job.

  2. Press ENTER. The End-of-Job Checking + Actions screen appears:

     24.10.08               ***** Entire Operations *****                    13:04:16 
      Owner   SN            End-of-Job Checking + Actions   MVS/ESA   Job IEFBR14   
      Network A-1                                          Run       Date           
      ------------------------------------------------------------------------------
      C Action       Step       will be checked for                         means OA
      _              ANYSTEP    Condition Code =  C0004                      --     
      _                                                                             
      _                                                                             
      _                                                                             
      _                                                                             
      _                                                                             
      _                                                                             
      _                                                                             
      ******************************* Bottom of Data *******************************
      _       ST X   All Checks ok                                                  
      _       S      Any Check not ok                                               
      ------------------------------------------------------------------------------
      A Activat. C Cond.  D Delete  E Ed Usr Rtn  J JV  L Rel Res  M Modify  O Other
      P Descr. R Recov. S SYSOUT T Output Mgmt  U User Msg X Action Rtn Y Symbol Set
                                                                                   
      Command => ____________________________________________________________       
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   End         Save        Up    Down                    Menu

Columns: End-of-Job Checking and Actions

The columns on the End-of-Job Checking and Actions screen are described in the following table:

Column Description
One-character line command input field. For an explanation of possible line commands, see Line Commands: End-of-Job Checking and Actions.
Action  Summary of defined actions for the event. The character(s) here correspond to the line commands at the bottom of the screen.
Step  Step name in JCL (ANYSTEP means all steps) (z/OS only ).
will be checked for Event to be checked for (condition code, system code, user abend code, System message, etc.)
means  Event status after check (All checks ok / Any check not ok).
OA

This column only contains entries if an event occurred during job execution.

The entries under O indicate the status of the event check, the entries under A indicate whether the action defined for the event was performed:

Entry O A
blank Event was not checked. No action performed.
- Event did not occur. n/a
+ Event occurred. Action performed.
E Error occurred during event check. One or more actions performed erroneously.
M Event definition was modified. Action definition was modified.

Line Commands

You can use the line commands to maintain the events and the actions to be triggered. All actions can be defined for an event (job step) or at the job level.

Start of instruction set To define an action at the job level

  • Enter the required line command in the appropriate input field preceding the All checks ok or Any check not ok field.

The following line commands are available:

Cmd Description
A Activate a job or network if selected event occurs.
C Define or modify the condition to be set or reset when the selected event occurs.
D Delete an event definition.
E Edit the user exit to be executed if the selected event occurs.
J Add or modify job variable (BS2000 only).
L Release resource.
M Modify an event definition.
z/OS/, z/VSE
BS2000
UNIX, Windows
O Other actions.
P Description. Write a text description of an event.
R Define a recovery action to be executed if the selected event occurs (normally job failure).
S Define job SYSOUT handling on job completion, if the selected event occurs.
T Pass files to Entire Output Management.
U Define message to be sent if the selected event occurs.
X Define a Natural user exit to be executed if the selected event occurs. This is called an End-of-Job Action User Exit.
Y Define symbol modification or setting.

Note that the D (DELETE), E (EDIT) and M (MODIFY) line commands are event maintenance commands, and therefore available at the event level only. All other line commands are also available at the job level according to All checks ok and Any check not ok.

Use the following PF keys to maintain event definitions and define actions to be triggered at job termination.

  • Press PF2 (Add) to save the definition and clear the window to add another event. You can define any number of events for any one job.

  • Press PF5 (Save) to save the event definition(s).

  • Press PF3 (End) to close the window and return to the End-of-Job Checking and Actions Screen. The new events are listed on this screen.