Job step termination exit

The sample library member EQQACTR1 contains the assembler source code of an SMF job/step termination exit, IEFACTRT. The sample contains two subroutines:
  • OPCASUB provides the necessary HCL Workload Automation for Z code to track job- and step-end events.
  • LOCALSUB generates WTO messages for step- and job-end.

If you use the HCL Workload Automation for Z Restart and Cleanup functionality or other functions, such as the one related to the NOERROR table (for details, see Customization and Tuning), you are required to install this exit. Use the sample provided with the product to install this exit.

From the introduction of the usability enhancement on, the IEFACTRT exit creates two different tables in the joblog, the Steptable ad the Not_Executed_Step_Table.

If you use the HCL Workload Automation for Z Restart and Cleanup functionality or other functions, such as the one related to the NOERROR table, and you want to replace this subroutine with your own, you need to comply with the following restrictions:
  • The fields JOBNAME, STEPNAME, PROCSTEP and STEPNO must continue to be filled on the basis of the following logic:
    • JOBNAME must contain the name of the job.
    • STEPNAME is the label of the EXEC PROC=... Card and must be filled only if a PROC is used.
    • PROCSTEP is the label of the EXEC PGM=... Card and must be filled also if a PROC is not used.
    • STEPNO must contain the sequence number of the steps inside the job.
  • The JOBNAME, STEPNAME, PROCSTEP identifiers in the tables header must match the values specified in the HDRJOBNAME, HDRSTEPNAME, and HDRPROCNAME parameters of the DSTOPTS DATASTORE statement.
  • The layout of STEPTABLE and NOT_EXECUTED_STEP_TABLE must be in compliance with the following rules:
    • JOBNAME must be preceded by a hyphen sign (-), some characters can be inserted between a hyphen sign and the JOBNAME.
    • JOBNAME must be followed by a blank.
    • STEPNAME must be preceded and followed by a blank.
    • PROCSTEP must be preceded and followed by a blank.
    • STEPNO must be preceded by a blank.
    • STEPNO must follow the PROCSTEP in the NOT_EXECUTED_STEP_TABLE.
  • NOT_EXECUTED_STEP_TABLE must be aligned to STEPTABLE as far as it concerns JOBNAME, STEPNAME and PROCSTEP information.
  • The string "JOBXXXXX ENDED. NAME-" must be aligned so that the JOBNAME JOBXXXXX is under the JOBNAME header.
  • JOBNAME, STEPNAME, PROCSTEP position in the STEPTABLE and in the NOT_EXECUTED_STEP_TABLE must match the values specified in the HDRJOBLENGTH, HDRSTEPLENGTH, HDRPROCLENGTH parameters of the DSTOPTS DATASTORE statement. STEPNO position in the STEPTABLE must match the value specified in HDRSTEPNOLENGTH.
  • User-customized records issued in the STEPTABLE and in the NOT_EXECUTED_STEP_TABLE must be avoided.