User exits for gathering z/OS SYSLOG data

If you plan to collect z/OS® SYSLOG data, you must install either the GLASYSG or GLAMDBG user exit. These user exits, and other modules that are used by these user exits, are provided with Operations Analytics for z Systems and are in the SGLALPA product library.

All modules in the SGLALPA library must be added to the system link pack area (LPA). For more information about the LPA, see the z/OS MVS Initialization and Tuning Guide.

The following modules are in the SGLALPA library:

You must install the GLASYSG or GLAMDBG user exit on the appropriate MVS™ installation exit. Table 1 indicates the MVS installation exit on which to install each user exit and describes how to choose which user exit to install.

Both user exits allocate a data space with a minimum size of 100 MB and a maximum size of 500 MB. The data space is used to store z/OS SYSLOG data for retrieval by the z/OS Log Forwarder.

Table 1. User exits with associated MVS installation exits and usage notes
User exit MVS installation exit on which to install the user exit Usage note for user exit
GLASYSG CNZ_MSGTOSYSLOG Install this user exit unless your z/OS system is running JES3 with the DLOG option enabled.
GLAMDBG CNZ_WTOMDBEXIT If your z/OS system is running JES3 with the DLOG option enabled, install this user exit.

Adding load modules to an LPA

To add the SGLALPA library to the pageable link pack area (PLPA) at system IPL, add the following statement to an LPALSTxx member. Replace zscala.v2r1m0 with the target library high-level qualifier that is used to install Operations Analytics for z Systems, and replace volume with the volume identifier of the data set.
zscala.v2r1m0.SGLALPA(volume)
To add the individual modules in the SGLALPA library to the dynamic LPA after the system IPL, issue the following MVS system commands:
SETPROG LPA,ADD,MODNAME=GLASYSG,DSNAME=zscala.v2r1m0.SGLALPA
SETPROG LPA,ADD,MODNAME=GLAMDBG,DSNAME=zscala.v2r1m0.SGLALPA
SETPROG LPA,ADD,MODNAME=GLADSRAW,DSNAME=zscala.v2r1m0.SGLALPA
SETPROG LPA,ADD,MODNAME=GLAGDSDL,DSNAME=zscala.v2r1m0.SGLALPA
SETPROG LPA,ADD,MODNAME=GLAGLMSG,DSNAME=zscala.v2r1m0.SGLALPA
SETPROG LPA,ADD,MODNAME=GLAUERQ,DSNAME=zscala.v2r1m0.SGLALPA

Installing user exits

To install a user exit on an MVS installation exit at system IPL, add one of the following statements to a PROGxx member:
  • EXIT ADD EXITNAME(CNZ_MSGTOSYSLOG) MODNAME(GLASYSG)
  • EXIT ADD EXITNAME(CNZ_WTOMDBEXIT) MODNAME(GLAMDBG)
To dynamically install a user exit after the system IPL, issue one of the following MVS commands:
  • SETPROG EXIT,ADD,EXITNAME=CNZ_MSGTOSYSLOG,MODNAME=GLASYSG
  • SETPROG EXIT,ADD,EXITNAME=CNZ_WTOMDBEXIT,MODNAME=GLAMDBG
Parent topic: Planning for configuration of the z/OS Log Forwarder