• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • IBM MQ filters

Settings API - IBM MQ filters schema table

IBM MQ filters (builtin:mainframe.mqfilters)

Dynatrace automatically traces CICS and IMS transactions originating from IBM MQ queues. To limit tracing to certain queues, specify their names in the include lists. To exclude queues from tracing, specify their names in the exclude lists. For IMS, these lists apply to message processing regions.

To only trace specific transactions submitted via the IMS bridge, specify their transaction IDs in the include list or exclude list.

Schema IDSchema groupsScope
builtin:mainframe.mqfilters
  • group:mainframe
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:mainframe.mqfilters
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:mainframe.mqfilters
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:mainframe.mqfilters

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyLabelTypeDescriptionRequired
cicsMqQueueIdIncludesCICS: Included MQ queuesset-required
cicsMqQueueIdExcludesCICS: Excluded MQ queuesset-required
imsMqQueueIdIncludesIMS: Included MQ queuesset-required
imsMqQueueIdExcludesIMS: Excluded MQ queuesset-required
imsCrTrnIdIncludesIMS bridge: Included transaction IDsset

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

required
imsCrTrnIdExcludesIMS bridge: Excluded transaction IDsset

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

required