Configuring the OSC logger exit routine by using the IMS refreshable logger exit routine

To configure the OSC logger exit routine by using the IMS refreshable logger exit routine, you must configure the Logger user exit (LOGWRT) routine provided by the Online Structure Change utility. The IMS refreshable logger exit routine allows multiple exit routines of the same type to be called in sequence.

About this task

In this task, you will configure the environment for the Logger user exit routine (LOGWRT) provided by the Online Structure Change utility (HFPFLGX0).

The executable load library of IMS High Performance Fast Path Utilities must be APF-authorized.

Procedure

  1. Specify the following EXITDEF parameter in the USER_EXITS section of the DFSDFxxx PROCLIB member. 
    EXITDEF=(TYPE=LOGWRT,EXITS=(HFPFLGX0))
  2. Update the IMS control region job to include in the STEPLIB concatenation the executable load library for IMS High Performance Fast Path Utilities, SHFPLMD0.
  3. Start the IMS control region. The following messages are issued if the logger exit routine is activated successfully: 
    HFP01000I LOGGER EXIT INITIALIZING              
HFP01503I JOINED XCF GROUP xxxxxxxx AS MEMBER yyyy
HFP01000I LOGGER EXIT INITIALIZED

What to do next

For detailed instructions on how to add the user exit definitions, see the topic "DFSDFxxx member of the IMS PROCLIB data set" in IMS System Definition.

Important:
  • In the //STEPLIB concatenations of all IMS control regions that share the same RECON data sets, IMS High Performance Fast Path Utilities must exist and they must be at the same maintenance level.
  • To use the BMP, CICS, and ODBA application pause features of IMS Tools Common Pauser, you must also define the IMS Tools Common Pauser logger exit routine (FOIVFLG0). Add FOIVFLG0 in the EXITDEF parameter of the USER_EXITS section of the DFSDFxxx member. 
    EXITDEF=(TYPE=LOGWRT,EXITS=(HFPFLGX0,FOIVFLG0))
  • To run an Online Structure Change utility job and an IBM® Security Guardium® S-TAP® for IMS on z/OS® job simultaneously in an IMS environment, the following APARs must be applied:
    • APAR PH27204 to IBM IMS Fast Path Solution Pack for z/OS
    • APAR PH27744 to IBM Security Guardium S-TAP for IMS on z/OS
  • To run an Online Structure Change utility job and an IMS Online Reorganization Facility job simultaneously in an IMS environment, APAR PH27204 and APAR PH40905 must be applied to IBM IMS Fast Path Solution Pack for z/OS.
  • To run an Online Structure Change utility job and an OEM product job that uses the logger exit routine simultaneously in an IMS environment, APAR PH40905 must be applied to IBM IMS Fast Path Solution Pack for z/OS.