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

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.Go Back To Product Page

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*