How do I determine if the required ACF2/JES2 exits are enabled and active?

Document ID : KB000026430
Last Modified Date : 14/02/2018
Show Technical Document Details

Question:  

How do I determine if the required ACF2/JES2 exits are enabled and active?

 

Answer:  

The ACF2 JES2 interface requires several exits points to be defined in the JES2 initialization parameters. The first step in debugging problems related to the ACF2/JES2 interface is to verify that the required exits are in place and active.

For z/OS 1.7 and above ACF2 requires the following JES2 Exits to be defined.

    LOAD(ACFJ2ITF) STOR=CSA 
    EXIT2 ROUTINE=ACFEXIT2 
    EXIT4 ROUTINE=ACFEXIT4 
    EXIT20 ROUTINE=ACFEXT20 
    EXIT24 ROUTINE=ACFEXT24 
    EXIT26 ROUTINE=ACFEXT26 
    EXIT31 ROUTINE=ACFEXT31 
    EXIT34 ROUTINE=ACFEXT34 
    EXIT46 ROUTINE=ACFEXT46 
    EXIT50 ROUTINE=ACFEXT50 
    EXIT52 ROUTINE=ACFEXT52 
    EXIT54 ROUTINE=ACFEXT54 
    EXIT56 ROUTINE=ACFEXT56 
    EXIT225 ROUTINE=ACFEX225 
    EXIT227 ROUTINE=ACFEX227,STATUS=DISABLE (Test message exit) LOAD(ACFJ2USR) STOR=CSA -OPTIONAL 
    EXIT223 ROUTINE=ACFJ2PRE,STATUS=DISABLE (Prevalidation) 
    EXIT224 ROUTINE=ACFJ2PST,STATUS=DISABLE (Postvalidation) 
    EXIT228 ROUTINE=ACFJ2PRU,STATUS=DISABLE (Prevalidation-user environment)
    EXIT229 ROUTINE=ACFJ2PSU,STATUS=DISABLE (Postvalidation-user environment) 

Exits 223,224,228 and 229 are optional and are defined to provide you with user exit points.

Exits 24, 26, 31, 34, 50, 52, 54, 56, 228, and 229 should not be defined if you are running z/OS 1.6 or below.

To verify that these exits are active, the $DEXIT JES2 operator commands can be issued.

$DEXIT(*) to display all JES2 exits status (see below **)

or

$DEXIT(nnn) to display a specific JES2 exit status

Or

$DEXIT,STATUS=ENABLED to show all enabled JES2 exits

Sample display output from $DEXIT(24):

    $HASP823 EXIT(24) 317                                           
    $HASP823 EXIT(24)   STATUS=ENABLED,ENVIRON=JES2,                
    $HASP823                 ROUTINES=(ACFEXT24),SPLEVEL=CHECK,TRACE=YES, 
    $HASP823                 USECOUNT=0         

The required ACF2 exits should display "STATUS=ENABLED" and the corresponding ACF2 ACF2/JES2 routine should be displayed in the ROUTINES=(ACFEXT24).

*Note that if there are multiple routines specified the ACF2 routine should be the last in the list, for example: ROUTINES=(EXITA24,EXITB24,ACFEXT24).

** Note: this command may result in the following messages due to the amount of information being passed back and is normal.

    $HASP003 RC=(57),D EXIT(*)  - DISPLAY TERMINATED DUE TO 
    $HASP003        EXCESSIVE OUTPUT (AS DEFINED BY CONDEF 
    $HASP003        DISPMAX)   

Additional Information:

Details on the ACF2/JES2 interface can be found in the CA ACF2 for  z/OS Systems Programmer Guide in Chapter 2: Installation Options section 
'CA ACF2 JES2 Interface'.