Upgrading user exit for collecting z/OS SYSLOG from Z Common Data Provider 2.1.0 to 5.1

If you are upgrading Z Common Data Provider 2.1.0 to 5.1 with the Log Forwarder gathering z/OS® SYSLOG data from a user exit, you must also upgrade the user exit modules.

• If you want to update the user exit for collecting z/OS SYSLOG at system IPL, perform the following steps.
  1. Update the LPALSTxx member with the LPA library updated by this PTF.
  2. Verify that one of the following EXIT ADD statements is added to the PROGxx member so that the EXIT will be activated during IPL.
     For JES2:

     EXIT ADD EXITNAME(CNZ_MSGTOSYSLOG) MODNAME(HBOSYSG)

     For JES3:

     EXIT ADD EXITNAME(CNZ_WTOMDBEXIT) MODNAME(HBOMDBG)

     Table 1. User exits for collecting z/OS SYSLOG data, with associated MVS installation exits and usage notes

     MVS™ installation exit on which to install the user exit	User exit	Usage note for user exit
     CNZ_MSGTOSYSLOG	HBOSYSG	If your z/OS system is not running JES3 with the DLOG option enabled, install this user exit.
     CNZ_WTOMDBEXIT	HBOMDBG	If your z/OS system is running JES3 with the DLOG option enabled, install this user exit.

  3. Perform system IPL.
• If you want to dynamically update the user exit without performing system IPL, perform the following steps.
  1. Stop the Log Forwarder if it is running.
  2. Run the batch utility HBOLFPCE in the hlq.SHBOSAMP data set.
     1. Update the following STEPLIB DD statement to specify the hlq.SHBOLOAD data set.

        //STEPLIB DD DISP=SHR,DSN=hlq.SHBOLOAD

     2. APF-authorize the hlq.SHBOLOAD library.
     3. Submit the job.
  3. If earlier version modules were dynamically added to the LPA library, delete the modules by running the following commands.

     SETPROG LPA,DELETE,MODNAME=GLASYSG,FORCE=YES
     SETPROG LPA,DELETE,MODNAME=HBOMDBG,FORCE=YES
     SETPROG LPA,DELETE,MODNAME=HBODSRAW,FORCE=YES
     SETPROG LPA,DELETE,MODNAME=HBOGDSDL,FORCE=YES
     SETPROG LPA,DELETE,MODNAME=HBOGLMSG,FORCE=YES
     SETPROG LPA,DELETE,MODNAME=HBOUERQ,FORCE=YES

  4. Load the modules into the dynamic LPA by running the following commands, where hlq.SHBOLPA is the LPA library updated by this PTF.

     SETPROG LPA,ADD,MODNAME=HBOSYSG,DSNAME=hlq.SHBOLPA
     SETPROG LPA,ADD,MODNAME=HBOMDBG,DSNAME=hlq.SHBOLPA
     SETPROG LPA,ADD,MODNAME=HBODSRAW,DSNAME=hlq.SHBOLPA
     SETPROG LPA,ADD,MODNAME=HBOGDSDL,DSNAME=hlq.SHBOLPA
     SETPROG LPA,ADD,MODNAME=HBOGLMSG,DSNAME=hlq.SHBOLPA
     SETPROG LPA,ADD,MODNAME=HBOUERQ,DSNAME=hlq.SHBOLPA

  5. Activate the user exit by running one of the following commands depending on the user exit you use:

     SETPROG EXIT ADD,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=HBOSYSG

     SETPROG EXIT ADD,EXITNAME=CNZ_WTOMDBEXIT,MODNAME=HBOMDBG

  6. Start the Log Forwarder.