Configuring Z APM Connect CICS TS Data Producer to create Distributed Transaction Processing (DTP) transaction filtering

You can edit the AGMSYSIN parameter data set to enable DTP-receiving CICS transaction monitoring.

About this task

Before APAR OA59484, CICS® cross-region transaction monitoring was only supported over the DPL facility. APAR OA59484 will now allow for DTP-receiving transactions to be included in monitoring.

Procedure

Modify the AGMSYSIN parameter data set, which is used for configuring CICS® TS Data Producer, with the new INCLUDE and EXCLUDE statements for filtering.

Refer to the following examples to add the proper INCLUDE or EXCLUDE statements.
Table 1. Examples of the INCLUDE statements
Example Description
TYPE=I,TRANSID=XYZA Monitor CICS transaction XYZA.
TYPE=I,TRANSID=XYZ* Monitor CICS transactions which have the first 3 characters as XYZ.
TYPE=I,TRANSID=XY* Monitor CICS transactions which have the first 2 characters as XY.
TYPE=I,TRANSID=X* Monitor CICS transactions which have the first characters as X.
Table 2. Examples of the EXCLUDE statements
Example Description
TYPE=E,TRANSID=XYZA Do not monitor CICS transaction XYZA.
TYPE=E,TRANSID=XYZ* Do not monitor CICS transactions which have the first 3 characters as XYZ.
TYPE=E,TRANSID=XY* Do not monitor CICS transactions which have the first 2 characters as XY.
TYPE=E,TRANSID=X* Do not monitor CICS transactions which have the first characters as X.
Note:
  • If no filters are defined, no DTP-receiving transactions will be tracked. This is the default.
  • If TRANSID=* is mentioned, all transactions are monitored. This is highly discouraged.
  • A maximum of 250 INCLUDE statements and a maximum of 250 EXCLUDE statements are allowed.
  • EXCLUDE entries in the AGMSYSIN parameter data set take precedence over INCLUDE statements.
  • CICS regions are not specified in the INCLUDE and EXCLUDE statements in AGMSYSIN parameter data set. The CICS transaction IDs specified in the INCLUDE and EXCLUDE statements pertain to the CICS transaction being executed in the CICS region/job to which the AGMSYSIN is allocated to. For DTP filtering purposes, it is imperative that AGMSYSIN parameter data set is unique for each CICS region.
  • Only one * is allowed when pattern matching is used for transaction IDs. If more than one is specified, the rightmost ones are ignored.
  • The leftmost * is taken into consideration for pattern matching. Any string after the * is ignored. For example, TRANSID=*ABC is same as TRANSID=* (All DTP transactions will be monitored).
  • You can use the modify command on the console to issue the AGMU,FILTER=DTP,LIST command in a CICS TS region to display the DTP transactions.