Run Job Security Exit

The Run Job security exit control point provides a standard interface for security verification of job streams before they are submitted to the job entry system. Specific implementation details include the following:

  • The Run Job exit is implemented as an executable load module.
  • The name of the load module is user-defined and cannot conflict with any IBM® Connect:Direct® load module names.
  • Specify RUN.JOB.EXIT=(modname) in the initialization parameters to activate the Run Job exit.
  • You must link-edit the module as re-entrant and place it in a load library that the IBM Connect:Direct DTF can access.
  • Because information passed to the exit is located above the 16 megabyte line, you must link-edit the module with AMODE ANY to make it capable of executing in 31-bit mode.

For additional information about exits, see IBM Connect:Direct Exits.

Sample Run Job Security Exits

The $CD.SDGASAMP library contains a sample source module for the most used z/OS security systems. Sample exit routines are:

  • DGAXRACJ for IBM RACF and CA-TOP SECRET
  • DGAXACRJ for CA-ACF2
  • DGAXSBRX

The sample exits are designed to ensure that correct security information is coded on each JOB statement in the job stream.

  • For IBM RACF and CA-TOP SECRET, a check is made for a valid USER and PASSWORD on each JOB card. If not found, a USER=submitter keyword is added to each JOB card.
  • For CA-ACF2, a JOBFROM=submitter keyword is added immediately following each JOB card to ensure that the correct security information is transferred to each submitted job.
  • An IBM Connect:Direct Stage2 Exit, DGAXSBRX can be used on the SNODE as RUN JOB EXIT to restrict and reject the use of RUN JOB function. As an exception, node names of PNODEs that are allowed to execute this function on this SNODE are defined in a node table of DGAXSBRX. If the nodename in process matches an entry in the table the function is allowed to continue otherwise the process is rejected with a return code of 8 and msgid of SVTM667I.

If you use one of these exits without coding a value for the RUN.JOB.EXIT initialization parameter, IBM Connect:Direct does not use the default for the RUNJOBID initialization parameter.

Note: Use the Run Job security exit to achieve user propagation for security checks when the job that executes is submitted by the user ID assigned to IBM Connect:Direct rather than the user ID that submitted the job. In most environments, this Exit is not needed.