Getting started with a CICS test scenario

Edit online

It is recommended that you start with this basic test scenario to get the core components in place and working.

Before you begin

Review the Prerequisites and system preparation.

About this task

Complete the following installation and configuration tasks to instrument the CICS application.

In this example, the Tomcat Enterprise Edition (TomEE) web server sends HTTP requests to the CICS subsystem to access the application.

Procedure

  1. Validate the distributed trace flow
    1. (Prerequisite) Install and configure AppDynamics Controller and the user interface
    2. Verify distributed application on the AppDynamics user interface
      Verify that the application is showing up on the AppDynamics user interface.
      Note: Before you deploy IBM Z® APM Connect , the AppDynamics user interface does not know which z/OS systems and subsystems the transactions are calling out. Only a node is displayed with the hostname of the IBM zSystems that the CICS is running on.
  2. Install and configure Z APM Connect Distributed Gateway
    Follow the instructions in Installing, configuring, and managing Z APM Connect Distributed Gateway to install and configure Z APM Connect Distributed Gateway.
  3. Install and configure Z APM Connect Base
    Follow the instructions in Installing and configuring Z APM Connect Base to install and configure Z APM Connect Base.
    Note: Make sure Z APM Connect Base is started successfully and connected to Z APM Connect Distributed Gateway. See Validating Z APM Connect Base installation and configuration to validate the status.
  4. Install and configure the Z APM Connect tracing component
    For this test scenario, only the Z APM Connect CICS Data Producer is required. Follow the instructions in Installing and configuring Z APM Connect CICS TS Data Producer to install and configure Z APM Connect CICS Data Producer.

Results

Your application is successfully instrumented with IBM Z APM Connect. What was previously a mainframe black box, surfaces one more layer of visibility as transactions hop between the web server and the CICS subsystem. You can also view the key details for individual transactions like response time, call count, ABEND codes, and more.

What to do next

Follow instructions in Installing and Configuring IBM Z APM Connect for AppDynamics APM to complete further installation and configuration.