IBM WebSphere MQ - Extended Discovery
Overview
The IBM_WebSphereMQExtendedDiscovery pattern performs a deep discovery of the distributed queue configuration, models Channels and Queues and creates the respective relationships between them and the IBM WebSphere MQ Software Instance.
Configuration Options
There are several configuration options available for this Extended Discovery:
domain_lookup := false; - allows to enable DNS domain lookup to search for related Host
model_system_q := false; - allows to model System Queues
model_system_ch := false; - allows to model System Channels
Example of the distributed queue configuration
The message exchange process in distributed queue is shown on the Figure 1 below:
Trigger
The IBM_WebSphereMQExtendedDiscovery pattern triggers on a SoftwareInstance that matches these criteria
- Type is IBM WebSphere MQ Series Queue Manager
- non-empty install root
- The runmqsc command is known to have worked on the host
Install root
The install root is inherited from the triggering SoftwareInstance.
Modeling Channels
Channels are modeled as Detail nodes of the IBM WebSphere MQ Series Queue Manager SoftwareInstance.
The IBM_WebSphereMQExtendedDiscovery pattern retrieves the list of channels from the runmqsc.exe application located in the bin folder of the install root using the following commands:
- On Windows:
- echo end|echo dis chl(*) all| "%install_root%\\bin\\runmqsc.exe" <MQ_INSTANCE>
- On UNIX:
- echo 'end'|echo 'dis chl(*) all'| %install_root%/bin/runmqsc <MQ_INSTANCE>
The following table describes the attributes returned by the command and the regular expressions that are used to retrieve their values:
| Modeled attribute | Description | Value examples | Regular Expression |
|---|---|---|---|
| name | Name of the channel | LONDON | CHANNEL\(([^\)]+)\) |
| type | Type of the channel | SDR - sender, CLUSSDR - cluster sender, SVRCONN - system channel, RCVR - receiver, CLUSRCVR - cluster receiver | CHLTYPE\(([^\)]+)\) |
| connection name | Remote host name and port where related QM channel is listening | 132.18.50.140(1414) | CONNAME\((\S+)\) |
| transmission queue | Transmission queue used by the channel | KIEV_SNDQ | XMITQ\(([^\)]+)\) |
| remote QM name | Remote QM name | PUNE | RQMNAME\(([^\)]+)\) |
Note
Modeling System Queues and Channels can be enabled in the configuration section of the pattern. It is disabled by default.
Modeling Local Queues
Local queues are modeled as Detail nodes of the either IBM WebSphere MQ Series Queue Manager SoftwareInstance (for normal local queues or queue aliases) or the Channel Detail node of the IBM WebSphere MQ Series Queue Manager SoftwareInstance (for local queues of the transmission type).
The IBM_WebSphereMQExtendedDiscovery pattern retrieves the list of local queues from the runmqsc.exe application located in the bin folder of the install root using the following commands:
- On Windows:
- echo end|echo dis ql(*) all| "%install_root%\\bin\\runmqsc.exe" <MQ_INSTANCE>
- echo end|echo dis qa(*) all| "%install_root%\\bin\\runmqsc.exe" <MQ_INSTANCE>
- On UNIX:
- echo 'end'|echo 'dis ql(*) all'| %install_root%/bin/runmqsc <MQ_INSTANCE>
- echo 'end'|echo 'dis qa(*) all'| %install_root%/bin/runmqsc <MQ_INSTANCE>
The following table describes the attributes returned by the command and the regular expressions that are used to retrieve their values:
| Modeled attribute | Regular Expression |
|---|---|
| name | ^([^\)]+) |
| cluster relation | CLUSTER\(([^\)]+)\) |
| type* | USAGE\(([^\)]+)\) |
| transmission queue | XMITQ\(([^\)]+)\) |
| remote QM name | RQMNAME\(([^\)]+)\) |
| max message length | MAXMSGL\(([^\) ]+)\) |
| max message depth | MAXDEPTH\(([^\) ]+)\) |
The type is identified for all Local Queues except Queue Aliases by looking for either "normal" or "transmission" substring in the resulting string.
Note
Modeling System Queues and Channels can be enabled in the configuration section of the pattern. It is disabled by default.
Modeling Remote Queues
Remote queues are modeled as Detail nodes of the Channel node that has them registered.
The IBM_WebSphereMQExtendedDiscovery pattern retrieves the list of remote queues from the runmqsc.exe application located in the bin folder of the install root using the following commands:
- On Windows:
- echo end|echo dis qr(*) all| "%install_root%\\bin\\runmqsc.exe" <MQ_INSTANCE>
- On UNIX:
- echo 'end'|echo 'dis qr(*) all'| %install_root%/bin/runmqsc <MQ_INSTANCE>
The following table describes the attributes returned by the command and the regular expressions that are used to retrieve their values:
| Modeled attribute | Description | Value examples | Regular Expression |
|---|---|---|---|
| name | Queue name | REM.INVENTQ | QUEUE\(([^\)]+)\) |
| name of the queue on remote QM | Name of the queue on remote QM | LOCAL.INVENTORY | RNAME\(([^\)]+)\) |
| remote QM name | Remote QM name | LONDON | RQMNAME\(([^\)]+)\) |
| transmission queue name | Related transmission queue | PUNEQ | XMITQ\(([^\)]+)\) |
Note
Modeling System Queues and Channels can be enabled in the configuration section of the pattern. It is disabled by default.
Relationship Creation
The pattern creates a containment relationship with IBM WebSphere MQ Software Instance for every channel and for every Local Queue Detail node of normal type, as they can be used by any channel within IBM WebSphere MQ.
The pattern also creates a containment relationship between the Remote Queue Detail and the Channel with the matching transmission queue.
Comments
Log in or register to comment.