ACF2/JES2 ACFJ2ITF and ACFJ2USR interface modules: function & purpose

Products

• ACF2
• ACF2 - DB2 Option
• ACF2 for zVM
• ACF2 - z/OS
• ACF2 - MISC
• PanApt
• PanAudit

Issue/Introduction

A description of the function and purpose of the ACF2/JES2 interface modules ACFJ2ITF and ACFJ2USR is provided.

 

Environment

Release: ACF2 R16.0               

 

Resolution

The ACF2 modules ACFJ2ITF and ACFJ2USR are part of the ACF2/JES2 interface.

MODULE NAME: ACFJ2ITF

FUNCTION: This module contains the ACF2 interface for JES2 z/OS sites. The ACF2/JES2 interface is responsible for assigning the logonid to be associated with each job, started task, or TSO session entering the system.

For batch jobs, the ACF2/JES interface must also validate the logonid associated with the job.

If the logonid is invalid, the ACF2/JES interface issues appropriate messages and instructs JES to cancel the job.

For started-tasks and tso-sessions, the ACF2/ JES2 interface does not validate the logonid for the task (this is done by other ACF2 MVS and TSO routines). For these tasks, the ACF2/JES interface assigns a logonid equal to the jobname.

This module is comprised of several csects:

 CSECT/EXIT   Description                                            
 ACFEXIT2     Job card scan routine
 ACFEXIT4     JCL card scan routine
 ACFEXT20     End-of-RDR manager
 ACFEXT24     Post-Initialization Exit
 ACFEXT26     Termination Exit
 ACFEXT31     SSI Data Set Allocation Exit
 ACFEXT34     SSI Data Set Unallocation Exit 
 ACFEXT46     NJE Transmit Exit
 ACFEXT50     End-of-RDR manager - user environment
 ACFEXT52     Job card scan routine - user environment
 ACFEXT54     JCL card scan routine - user environment
 ACFEXT56     NJE Transmit Exit - user environment
 ACFEX225     Subtask attach/post routine
 ACFEX227     Debug message routine

MODULE NAME: ACFJ2USR

FUNCTION: . Note that the user exits only gain control for batch jobs.

This module is comprised of several csects:

 CSECT/EXIT   Description                                            
 ACFJ2PRE     Prevalidation user exit  
 ACFJ2PST     Postvalidation user exit
 ACFJ2PRU     Prevalidation user exit - user environment
 ACFJ2PSU     Postvalidation user exit - user environment

Note: Routines defined as "user environment" are only valid with JES2 for z/OS 1.7 and above.

All of the ACF2/JES exits are defined in the JES2 initialization parameters. 

 

Additional Information

Details on the ACF2/JES2 interface can be found in the TechDoc under Perform JES2 Modifications.