Settings API - Transaction monitoring schema table
Transaction monitoring (builtin:mainframe.txmonitoring)
Define additional monitoring settings for CICS and IMS transactions.
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:mainframe.txmonitoring |
| environment |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:mainframe.txmonitoring |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:mainframe.txmonitoring | |
| Environment ActiveGate | https://{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
| Property | Type | Description | Required |
|---|---|---|---|
Monitor all incoming web requestsmonitorAllIncomingWebRequests | 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 GatewaymonitorAllCtgProtocols | 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 CICSPlexgroupCicsRegions | 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 IDszosCicsServiceDetectionUsesTransactionId | 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 subsystemgroupImsRegions | 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 IDszosImsServiceDetectionUsesTransactionId | 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 callnodeLimit | integer | We recommend the default limit of 500 nodes. The value 0 means unlimited number of nodes. | required |