Event-step-ready

Indicates that a job step is about to be executed. This event is similar to Event-before-PGM-call, except that this event occurs in the parent process and enables the user exit to change information such as program name, whereas Event-before-PGM-call does not.

This event enables the user exit to examine or change program alias name, program name and parameter string information.

This event does not occur for TSO sessions.

Event-specific data:

Data available for this event includes:

  • Program name and alias.
  • Program parameter string; that is, the equivalent of the PARM= parameter of JCL.

Actions:

The following actions can be requested for this event:

action-PGM-info
Indicates that JCL should use the modified program name or program alias and/or parameter string. If the program name, as opposed to program alias, is changed, it is looked up in the alias list to determine if there is an alias for it. If so, the new alias will be used.
action-abend
Indicates that the step should be abended with the system abend S822 (Region not available). Execution of subsequent steps will be then be based on this abend.