Settings API - Transaction start filters schema table

Transaction start filters (builtin:mainframe.txstartfilters)

Dynatrace automatically traces CICS and IMS transactions when monitored services call them. Transactions that originate on the mainframe, on a terminal, or are called by unmonitored services must be explicitly listed to be monitored.

Add CICS and IMS transactions originating on a terminal (e.g., IBM 3270 green screen terminal) to the terminal transaction start filter. Add all other transactions to the transaction start filters.

Note that traces started using the transaction filters will never be linked to a previous trace, regardless of how the transaction was initiated.

Schema ID
Schema groups
Scope
builtin:mainframe.txstartfilters
  • group:mainframe
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:mainframe.txstartfilters
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:mainframe.txstartfilters
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:mainframe.txstartfilters

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

Property
Type
Description
Required
CICS terminal transaction start filter
includedCicsTerminalTransactionIds
set

You can use * as wildcard. For example use A* to trace all transaction IDs that start with A.

required
CICS transaction start filter
includedCicsTransactionIds
set

You can use * as wildcard. For example use A* to trace all transaction IDs that start with A.

required
IMS terminal transaction start filter
includedImsTerminalTransactionIds
set

You can use * as wildcard. For example use A* to trace all transaction IDs that start with A.

required
IMS transaction start filter
includedImsTransactionIds
set

You can use * as wildcard. For example use A* to trace all transaction IDs that start with A.

required