For every CICS® region to be monitored, you need
to install CICS TS Data Producer.
Before you begin
Before you install CICS TS Data Producer, ensure that you
have CICS Transaction Server V5.6 or later
installed.
Procedure
-
Add the AGMPINIT program to the CICS Stage 2
post-initialization (PLTPI) after the DFHDELIM statement.
For example, a CICS PLTPI with AGMPINIT program is
added:
DFHPLT TYPE=INITIAL,SUFFIX=MM
DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM
DFHPLT TYPE=ENTRY,PROGRAM=AGMPINIT
DFHPLT TYPE=FINAL
Tip: If you want to start
CICS TS Data Producer without
adding the AGMPINIT program to the PLT, run the AGMU CICS
transaction with the
START parameter. For more information, see
AGMU commands.
-
Define the CICS TS Data Producer resources to CICS.
-
Edit the SAGMSAM library member AGMSCSDU to match
your IBM Z® APM Connect target libraries.
-
Change the
ADD GROUP command to point to a group list that is installed in the
CICS region.
-
Run the sample job to define the required resources.
Note: The AGMUCSDU job defines a LIBRARY(SAGMMODR). At
this time, the SAGMMODR library is required, and can not be replaced by
DFHRPL DD or STEPLIB DD statements due to the way Z APM
Connect loads the required libraries.
Note: If you do not plan to use the SMP/E target libraries, copy members into data sets with the
same high-level qualifier. There is a dependency that resulting SAGMMOD* data
sets must keep that same high-level qualifier.
-
Restart your CICS regions to activate CICS TS Data Producer.
Conditional: If a CICS restart is not
possible, you can log on to the CICS region, use CEDA
INSTALL GROUP(AGMDEFS) to define the resources to CICS, and then use the AGMU,START transaction to initialize IBM Z APM Connect in the CICS region.
Results
CICS TS Data Producer successfully links to the Z APM Connect Base when the AGMP1043I message is written to
the CICS control region syslog. CICS TS Data Producer is operational when the message AGMP1058I is written to
the CICS control region syslog.