Settings API - Transaction monitoring schema table

Transaction monitoring (builtin:mainframe.txmonitoring)

Define additional monitoring settings for CICS and IMS transactions.

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

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

PropertyTypeDescriptionRequired
Monitor all incoming web requests
monitorAllIncomingWebRequests		boolean

Dynatrace automatically traces incoming web requests when they are called by already-monitored services. Enable this setting to monitor all incoming web requests. We recommend enabling it only over a short period of time.

required
Monitor all EXCI requests from CICS Transaction Gateway
monitorAllCtgProtocols		boolean

If enabled, the CICS Transaction Gateway sensor will trace all EXCI requests including those that are using the TCP/IP or SNA protocol.

required
Group CICS regions that belong to the same CICSPlex
groupCicsRegions		boolean

If enabled, CICS regions belonging to the same CICSPlex will be grouped into a single process group. If disabled, a process group will be created for each CICS region.

required
Create CICS services based on transaction IDs
zosCicsServiceDetectionUsesTransactionId		boolean

If enabled, a CICS service will be created for each monitored transaction ID within a process group. If disabled, a CICS service will be created for each monitored CICS region within a process group. We recommend enabling it only when the CICS regions are grouped by their CICSPlex.

required
Group IMS regions that belong to the same subsystem
groupImsRegions		boolean

If enabled, IMS regions belonging to the same subsystem will be grouped into a single process group. If disabled, a process group will be created for each IMS region.

required
Create IMS services based on transaction IDs
zosImsServiceDetectionUsesTransactionId		boolean

If enabled, an IMS service will be created for each monitored transaction ID within a process group. If disabled, an IMS service will be created for each monitored IMS region within a process group. We recommend enabling it only when the IMS regions are grouped by their subsystem.

required
PurePath node limit: maximum number of nodes per CICS/IMS program call
nodeLimit		integer

We recommend the default limit of 500 nodes. The value 0 means unlimited number of nodes.

required