• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Transaction monitoring

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
Retrieve schema via Settings API
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

PropertyLabelTypeDescriptionRequired
monitorAllIncomingWebRequestsMonitor all incoming web requestsboolean

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
monitorAllCtgProtocolsMonitor all EXCI requests from CICS Transaction Gatewayboolean

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

required
groupCicsRegionsGroup CICS regions that belong to the same CICSPlexboolean

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
zosCicsServiceDetectionUsesTransactionIdCreate CICS services based on transaction IDsboolean

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
groupImsRegionsGroup IMS regions that belong to the same subsystemboolean

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
zosImsServiceDetectionUsesTransactionIdCreate IMS services based on transaction IDsboolean

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
nodeLimitPurePath node limit: maximum number of nodes per CICS/IMS program callinteger

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

required