Enabling the BRNVYNEX dynamic exit

BRNVYNEX is the SYS.IEFUJV exit manager. The LEGFILE is built by program BRNVLEGX from the LEGTABLE file to assign replacement program names. The edited LEGFILE is loaded into extended CSA for the exit program to use during JCL processing. This allows identification of job steps where the executing program should be changed.

About this task

Best practice is to run this module as a started task, although you can also run it as a job.

Figure 1. BRNDYNEX JCL Example
//BRNDYNEX EXEC PGM=BRNVYNEX,PARM='DSN=hlq.SBRNLOAD,EXITNAME=SYS.IEFUJV'
//STEPLIB  DD  DISP=SHR,DSN=hlq.SBRNLOAD
//SYSPRINT DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//REPORT   DD  SYSOUT=*
//INFILE   DD  DISP=SHR,DSN=hlq.USERMAC(LEGFILE)
Note: The BRNDYNEX job defaults to activating the SYS.IEFUJV exit. If the JES2 IEFUJV exit is configured, change the EXITNAME= parameter to SYSJES2.IEFUJV. If the JES3 IEFUJV exit is configured, change the EXITNAME= parameter to SYSJES3.IEFUJV. See SMF system recording options.

Procedure

  1. Copy the PARM for the BRNDYNEX started task in the library that contains the module BRNVIUJV. This is the same as the library specified in the STEPLIB.
  2. Ensure STEPLIB is an authorized library.
  3. Customize hlq.CNTL(VFILEGX) to use your data set naming conventions. Submit and run VFILEGX to create the hlq.LEGFILE data set.
  4. Customize hlq.USERMAC(LEGFILE) with the data set name of the LEGFILE created in the previous step.
    hlq.LEGFILE
    Note: You can use the sample JCL member hlq.CNTL(BRNDYNEX). Define an authorized STEPLIB and modify the PARM value to specify the data set that contains the BRNVIUJV module.
  5. To configure the BRNVYNEX started task so that it cannot be canceled, add the following PPT (Program Properties Table) entry to your SCHEDXX PARMLIB:
             1         2         3         4         5         6        
    ....+....0....+....0....+....0....+....0....+....0....+....0..     
                                                                            
    PPT  PGMNAME(BRNVYNEX) /* BRNVYNEX                        */         
             NOCANCEL      /* CANNOT BE CANCELLED             */         
             SWAP          /* PROGRAM IS SWAPPABLE            */         
             DSI           /* REQUIRES DATA SET INTEGRITY     */         
             PASS          /* NOT ALLOWED TO BYPASS PASS PROT */
             SYST          /* SYSTEM TASK SO NOT TIMED        */         
             AFF(NONE)     /* NO PROCESSOR AFFINITY           */  
             NOPREF        /* NO PREFERRED STORAGE FRAMES     */