Dynamically updating the user exit

You can dynamically update the user exit according to your needs.

Procedure

To update the user exit for collecting z/OS® SYSLOG data, complete this procedure.

  1. Stop the Log Forwarder or the Data Collector if it is running to collect SYSLOG data.
  2. Copy the batch utility HBOLFPCE in the SHBOSAMP data set to a user job library, update the following STEPLIB DD statement to specify the hlq.SHBOLOAD data set and run the batch job.
    //STEPLIB  DD DISP=SHR,DSN=HBOvrm.SHBOLOAD
  3. If the individual modules were dynamically added to the LPA library after the system IPL, run the following commands to delete the modules:
    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. Run the following commands to load the modules into the dynamic LPA. hlq.SHBOLOAD is the LPA library that is updated.
    SETPROG LPA,ADD,MODNAME=HBOSYSG,DSNAME=hlq.SHBOLOAD
    SETPROG LPA,ADD,MODNAME=HBOMDBG,DSNAME=hlq.SHBOLOAD
    SETPROG LPA,ADD,MODNAME=HBODSRAW,DSNAME=hlq.SHBOLOAD
    SETPROG LPA,ADD,MODNAME=HBOGDSDL,DSNAME=hlq.SHBOLOAD
    SETPROG LPA,ADD,MODNAME=HBOGLMSG,DSNAME=hlq.SHBOLOAD
    SETPROG LPA,ADD,MODNAME=HBOUERQ,DSNAME=hlq.SHBOLOAD
    
  5. Activate the user exit, depending on the user exit you use:
    • If you installed the CNZ_MSGTOSYSLOG user exit, run the following command:
      SETPROG EXIT ADD,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=HBOSYSG
    • If you installed the CNZ_WTOMDBEXIT user exit, run the following command:
      SETPROG EXIT ADD,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=HBOSYSG
  6. Start the Log Forwarder or the Data Collector.