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.

Procedure

  • 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=HBOSYSG,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.

What to do next

For more information about upgrading other components, see Upgrading the Z Common Data Provider.