Tracking CICS to MQ to an Instana monitored application

This feature allows for the continued tracing of transactions as they go from CICS to a (distributed) application traced by Instana using MQ as an intermediary. To use this feature, you need to edit the AGMSYSIN parameter data set to add each queue name that is used as the message passing queue.

About this task

PTF UJ95620 (APAR OA66562) along with Fix pack 7 allows for tracing MQ queues outbound to distributed applications instrumented by Instana. Complete the following steps to trace MQ outbound.

1. Add the following statement to the AGMSYSIN parameter data set of the CICS region where the MQPUT is being done:

   TYPE=O,QUEUE=MY_OUTBOUND_QUEUE

2. To pick up the changes to AGMSYSIN, use AGMU,STOP command followed by AGMU,START command. There is no need to recycle the CICS region.
   Note:

   • MY_OUTBOUND_QUEUE is the name of the queue that needs to be tracked in the CICS region which issues the MQPUT call.
   • A maximum of 170 queues are allowed to track for a CICS region. However, only a maximum of 10 queues are allowed per CICS task.
   • An MQ Monitoring Subsystem needs to be set up for this feature. For more information about the configuration, see Setting up the IBM Z APM Connect IBM MQ monitoring agent subsystem.
   • You can edit the AGMSYSIN parameter data set to enable the CICS TS data producer to generate tracing spans for a Long Running CICS transaction at SYNCPOINT. See Configuring Z APM Connect CICS TS Data Producer for Long Running CICS transaction