Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Search for | Example | Results |
---|---|---|
A single word | cat
|
Topics that contain the word "cat". You will also find its grammatical variations, such as "cats". |
A phrase. You can specify that the search results contain a specific phrase. |
"cat food" (quotation marks) |
Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase. |
Search for | Operator | Example |
---|---|---|
Two or more words in the same topic |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
Discovery Mechanism
WebSphere MQ can be installed on several UNIX platforms and Microsoft Windows, and is managed using a command line interface standardized across platforms. The command line interface is accessible through programs, runqsc or runmqadm, that are included in a WebSphere MQ installation.
The MQ by Shell job uses the Shell CI associated with a server as its trigger. Because every server in the CMDB may have an associated Shell CI, the trigger query results contain the Shell CI only for servers on which WebSphere MQ software is installed.
The MQ by Shell job uses the WebSphere MQ command line interface to query for MQ objects and their details. Since the runmqsc command requires administrator or root privileges and the runmqadm command is not always available, the job attempts the runmqadm -r command first. If runmqadm fails, the job tries the runmqsc command.
After logging in to the MQ server using the Shell CI (created by the Host Connections by Shell job), DFM:
-
Identifies the version of WebSphere MQ installed on the server. This is done using the dspmqver command. (If dspmqver fails, the mqver command is attempted.)
-
Retrieves a list of WebSphere MQ Queue Managers using the dspmq command.
-
Retrieves details on each Queue Manager using the MQ CLI (command line interface) command:
DISPLAY QMGR DESCR DEADQ DEFXMITQ REPOS CCSID
-
Retrieves a list of queues on each Queue Manager using the MQ CLI command:
DISPLAY QUEUE(*) TYPE DESCR CLUSTER CLUSNL USAGE RNAME RQMNAME XMITQ TARGQ DEFTYPE
Relationships between queues and other MQ objects such as other queues, Queue Managers, and so on, are built on the fly.
-
Retrieves (for each
TRANSMIT Queue
found) the remote server name and IP and port using the sender channel associated with the transmit queue. This is done using the MQ CLI command:DISPLAY CHANNEL(*) WHERE(xmitq EQ <transmitQueueName>) TYPE(SDR) CONNAME
-
Retrieves a list of channels on each Queue Manager using the MQ CLI command:
DISPLAY CHANNEL(*) CHLTYPE TRPTYPE DESCR CLUSTER CLUSNL CONNAME XMITQ
Relationships between channels and other MQ objects such as other queues, channels, and so on, are built on the fly.
-
Retrieves a list of clusters that each Queue Manager is a member of, or knows about, using the MQ CLI command:
DISPLAY CLUSQMGR(*) CONNAME QMTYPE
Relationships between clusters and other clusters are built on the fly.
-
Retrieves the
namelists
that each Queue Manager is a member of, or knows about, using the MQ CLI command:DISPLAY NAMELIST(*) NAMES NAMCOUNT DESCR