Installing Z APM Connect IMS Data Producer

For every IMS region and IMS Connect to be monitored, you need to install an IMS Data Producer.

Before you begin

Before you install IMS Data Producer, ensure that you have IMS V14 or later installed.

Do you use IBM Tools Base for z/OS and IMS Tools partner exits? If yes, go to Procedure for IMS Tools Partner Exits to complete the required configuration first.

If you are using IMS MQ Bridge to trace IMS MQ transaction, follow Optional IMS MQ Bridge Configuration to complete the required configuration.

If you are not using IMS Connect or not routing IMS transaction through IMS Connect, you can skip step 1 and not configure IMS Connect.

Note: Z APM Connect MQ monitoring agent subsystem is NOT required for tracking IMS MQ Bridge transactions.

Procedure

  1. (Only if you are using IMS Connect) In the IMS Connect PROC, add the <hilev>.SAGMMOD library to the <STEPLIB> concatenation.
    The <hilev>.SAGMMOD library contains an alias to the HWSTECL0 user exit which IMS Connect searches for and, if found, loads it to setup Z APM Connect into the IMS Connect environment.
  2. In the IMS PROCLIB member DFSDFxxx, add the following user exit definition:
    • For IMS V15
      *--------------------------------------------------------------------*
      * IMS USER EXITS                                                     *
      *--------------------------------------------------------------------*
      <SECTION=USER_EXITS>                                                                            
       EXITDEF=(TYPE=PPUE,EXITS=(AGMPPUE0))
    • For IMS V14
      *--------------------------------------------------------------------*
      * IMS USER EXITS                                                     *
      *--------------------------------------------------------------------*
      <SECTION=USER_EXITS>                                                                         
       EXITDEF=(TYPE=PPUE,EXITS=(AGMPPUE0))
  3. In the IMS Control Region PROC, add the <hilev>.SAGMMOD library to the <STEPLIB> concatenation.
    Note: Ensure that <hilev>.SAGMMOD is APF authorized.
  4. Start IMS and IMS Connect (if used).

Results

IMS Data Producer successfully links to Z APM Connect Base when you see the following messages in the IMS Connect syslog at startup time:
AGMI1000I zAPM EVENT RECORDER USER EXIT - INITIALIZATION COMPLETE
AGMI1001I AGMTECL0 LEVEL: (IMSCOM-HAPMvvv-yyyymmdd-hh.ss)
AGMI1001I AGMTEC0E LEVEL: (IMSE10-HAPMvvv-yyyymmdd-hh.ss)

If Z APM Connect Base is started after IMS Control Region has been configured and started, the following messages will be reported in the IMS Control Region job log:

AGMI1200I zAPM IMS LOGICAL LOGGER EXIT INITIALIZATION COMPLETE
AGMI1201I AGMILL LEVEL: (IMSE10-OA60018-20200827-10.39)
Note: If Z APM Connect Base is started before IMS Connect and IMS Control Region has been started, the above messages will NOT be reported until the first transaction is processed.

What to do next

If the subsystem name for the Z APM Connect Base is the default name AGMZ, no further configuration is required. Otherwise, you are required to configure IMS Data Producer. For more information, see Configuring Z APM Connect IMS Data Producer.