IBM MQ tracing
Dynatrace can automatically create a continuous Service flow for IBM MQ when the producer and consumer services use the same queue or topic name. If the producer and consumer services refer to different queue or topic names, IBM MQ configuration might be required to create a continuous service flow.
Without IBM MQ configuration, Dynatrace can still trace all messages, but the service flow will be broken.
Technology | IBM MQ message | IBM MQ configuration required |
---|---|---|
z/OS Java .NET | ||
IBM App Connect EnterpriseIBM Integration Bus |
|
Frequently asked questions
Manage IBM MQ configuration
You can manage an IBM MQ configuration automatically by installing an IBM MQ extension and activating Retrieve topology for improved transaction tracing to retrieve the IBM MQ configuration of your environment and send it to the Settings API. This can also be done manually via the web UI or the Settings API.
Manual configuration via web UI
To manage the IBM MQ configuration via the Dynatrace web UI, from the Dynatrace menu, go to Settings > Mainframe to find the following menu options:
- IBM MQ queue managers
- IBM MQ queue sharing groups
- IBM MQ IMS bridges
Manual configuration via Settings API
You can manage the IBM MQ configuration via the Dynatrace Settings API.
To be able to use the API you need an access token with Read settings (settings.read
) and Write settings (settings.write
) scopes. To learn how to obtain it, see Create an access token.
Configuration items
The table lists the available IBM MQ configuration items for queues and topics.
Item | Description | Your action |
---|---|---|
Queue manager | Queue manager with its queues | Define your queue managers, including alias queues, remote queues, and cluster queues within a single configuration item. |
z/OS Queue sharing group | Group of queue managers that access the same shared queues | Specify which queue managers and shared queues belong to a queue-sharing group within a single configuration item. |
z/OS IMS bridge | The IBM MQ component that allows direct access to the IMS system | Specify which queue managers and queues belong to an IMS bridge within a single configuration item. |
Follow the procedures below to create or update a configuration item. Note that the scope of these items is always an environment. Before starting, learn the format of the settings object by querying its schema via the GET a schema call.
New queue manager
The ID of the queue manager schema is builtin:ibmmq.queue-managers
.
-
Create the JSON object for your settings.
The
aliasQueues
object can be a local queue owned by this queue manager, a local definition of a remote queue, or a cluster queue visible by this queue manager but owned by another queue manager. -
Use the POST an object endpoint to send your configuration.
New queue sharing group
The ID of the queue sharing group schema is builtin:ibmmq.queue-sharing-group
.
-
Create the JSON object for your settings.
-
Use the POST an object endpoint to send your configuration.
New IMS bridge
The ID of the IMS bridge schema is builtin:ibmmq.ims-bridges
.
-
Create the JSON object for your settings.
-
Use the POST an object endpoint to send your configuration.
Update queue manager
The ID of the queue manager schema is builtin:ibmmq.queue-managers
.
The aliasQueues
object can be a local queue owned by this queue manager, a local definition of a remote queue, or a cluster queue visible by this queue manager but owned by another queue manager.
-
Query the current configuration via the GET objects call.
-
Create the JSON for your update.
-
Use the updateToken value from the previous step.
-
Modify the values as needed.
-
-
Use the PUT an object endpoint to send your configuration.
Update sharing group
The ID of the queue sharing group schema is builtin:ibmmq.queue-sharing-group
.
-
Query the current configuration via the GET objects call.
-
Create the JSON for your update.
- Use the updateToken value from the previous step.
- Modify the values as needed.
-
Use the PUT an object endpoint to send your configuration.
Update IMS bridge
The ID of the IMS bridge schema is builtin:ibmmq.ims-bridges
.
-
Query the current configuration via the GET objects call.
-
Create the JSON for your update.
-
Use the updateToken value from the previous step.
-
Modify the values as needed.
-
-
Use the PUT an object endpoint to send your configuration.