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
-
(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.
-
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))
-
In the IMS Control Region PROC, add the <hilev>.SAGMMOD library to the
<STEPLIB>
concatenation.
Note: Ensure that <hilev>.SAGMMOD is APF authorized.
-
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.