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.
-
Update the
LPALSTxx
member with the LPA library updated by
this PTF.
-
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. |
-
Perform system IPL.
-
If you want to dynamically update the user exit without performing system IPL, perform the
following steps.
-
Stop the Log Forwarder if it is running.
-
Run the batch utility
HBOLFPCE
in the
hlq.SHBOSAMP
data set.
- Update the following
STEPLIB DD
statement to specify the
hlq.SHBOLOAD
data
set.//STEPLIB DD DISP=SHR,DSN=hlq.SHBOLOAD
- APF-authorize the
hlq.SHBOLOAD
library.
- Submit the job.
-
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
-
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
-
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
-
Start the Log Forwarder.
What to do next
For more information about upgrading other components, see Upgrading the Z Common Data Provider.