Custom rules for CICS, IMS and MQ monitoring

Dynatrace automatically traces CICS and IMS transactions when they are called by already-monitored services. Transactions that start on the mainframe or are called by unmonitored services require specific rules to be monitored. There are two types of such rules:

  • Global level rules.
  • Process group level rules. These rules override global rules on a process group level

To define rules for monitoring transactions of unmonitored services

  1. Go to Settings > Server-side service monitoring > Deep monitoring.
  2. Expand the CICS, IMS, and MQ monitoring section and define the required rule. Find the details in the appropriate subsections below.

Transaction monitoring

You can monitor CICS and IMS transactions that start from a 3270 terminal by adding the transaction IDs to the monitoring filter.

  • Dynatrace automatically traces CICS and IMS transactions that are called from already-monitored services. You don't need to create rules for them.
  • Adding a transaction ID to the monitoring filter will start a new PurePath and it won't be linked to a previous subpath, regardless of how the transaction was initiated.
  1. Click Add CICS start transaction ID filter or Add IMS start transaction ID filter.
  2. Enter the transaction ID and click Add.

MQ queue monitoring

By default, Dynatrace captures all z/OS MQ queues. You can define rules to capture only transactions from certain CICS MQ or IMS MQ queues or to exclude certain CICS MQ or IMS MQ queues from capturing. For IMS these rules apply to application regions. To learn how to capture transactions from an IMS region, see IMS MQ Bridge transaction monitoring below.

Include queues

When you add a queue to the include list all other queues are ignored.

  1. Click Add CICS MQ queue ID include filter or Add IMS MQ queue ID include filter.
  2. Enter the queue ID and click Add.

Exclude queues

When you add a queue to the exclude list remaining queues are still monitored.

  1. Click Add CICS MQ queue ID exclude filter or Add IMS MQ queue ID exclude filter.
  2. Enter the queue ID and click Add.

IMS MQ Bridge transaction monitoring

By default, Dynatrace captures all the transactions that are submitted via IMS MQ Bridge. You can define rules to capture only the transactions that match the specified transaction IDs in the include filter or to exclude the transactions that match the transaction IDs in the exclude filter.

When you add a transaction ID to the include list, all the remaining transactions are ignored.

When you add a transaction ID to the exclude list remaining transactions are still monitored.

  1. Click Add IMS MQ transaction ID include filter or Add IMS MQ transaction ID exclude filter.
  2. Enter the transaction ID and click Add.

Node limit

The node limit is the maximum number of nodes in the PurePath, which will be captured for a single CICS or IMS program call. We recommend the limit of 500, which is the default. The value of 0 means unlimited number of nodes.

Caution

Increasing the limit above 500 might cause a significant CPU overhead on z/OS!