Installing Z APM Connect CICS TS Data Producer

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

  1. 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.
  2. Define the CICS TS Data Producer resources to CICS.
    1. Edit the SAGMSAM library member AGMSCSDU to match your IBM Z® APM Connect target libraries.
    2. Change the ADD GROUP command to point to a group list that is installed in the CICS region.
    3. 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.
  3. 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.