IBM Support

How to find out the version of the remote MQ code that is connected to the queue manager?

Question & Answer


Question

You want to find out the version of the remote MQ code that is connected to the desired WebSphere MQ queue manager.

Answer

The channel status in MQ 7.1 and later shows product and version of remote connection.
- Applies to both MCA channels and server-connection channels (SVRCONN)
- Remote system must be MQ V7.0 or higher – otherwise blank is shown
- It can distinguish Java, C, .Net client programs
- It helps MQ administrator to determine whether the connected partner needs upgrading

The new attributes are documented in the MQ product documentation:

WebSphere MQ>Reference>Administration reference>MQSC reference>The MQSC commands>
DISPLAY CHSTATUS
Use the MQSC command DISPLAY CHSTATUS to display the status of one or more channels.

RVERSION
The remote partner version. This is the version of the WebSphere MQ code running at the remote end of the channel. If the remote version is blank, the remote partner is at version 6 or earlier.
The remote version is displayed as VVRRMMFF

RAPPLTAG (enhanced in MQ 7.5 to show the name of the Java application)
The remote partner application name. This is the name of the client application at the remote end of the channel. This parameter applies only to server-connection channels.

RPRODUCT
The remote partner product identifier. This is the product identifier of the WebSphere MQ code running at the remote end of the channel. If the remote product identifier is blank, the remote partner is at version 6 or earlier. The possible values are

RPRODUCT Possible Values
Product Identifier values Product Identifier Description
MQMM Queue Manager (non z/OS Platform)
MQMV Queue Manager on z/OS
MQCC WebSphere MQ C client
MQNM WebSphere MQ .NET fully managed client
MQJB WebSphere MQ Classes for JAVA
MQJM WebSphere MQ Classes for JMS (normal mode)
MQJN WebSphere MQ Classes for JMS (migration mode)
MQJU Common Java interface to the MQI
MQXC XMS client C/C++ (normal mode)
MQXD XMS client C/C++ (migration mode)
MQXN XMS client .NET (normal mode)
MQXM XMS client .NET (migration mode)



+++ Examples

A variety of client applications were connected from remote hosts to a queue manager running MQ 7.5.

++ Using the MQ Explorer

The following screen shots were taken from MQ Explorer 7.5.

The Channel Status can be obtained as follows: from the left Navigator panel, select the folder "Channels". On the right panel, select the desired channel name, in this case SYSTEM.DEF.SVRCONN. Right click to bring up the context menu.
Select "Status" then "Channel Status..."



You will see the Channel Status window, which has the "Channel name" as the first column, but the columns "Remote version" and "Remote product" are the right-most columns, thus, you will need to scroll all the way to the right.
The following is a composite view that shows both ends of the window, in order to display the Channel name and the desired attributes.



Notice that the first entry has a "Remote version" of 07050000 which is equivalent to 7.5.0.0, and a "Remote product" of "MQJM" which means "WebSphere MQ Classes for JMS (normal mode)"

Notice that the second entry has a version of 7.1.0.2 and the product is " WebSphere MQ C client".


++ Using runmqsc

From a command prompt issue:

runmqsc QmgrName

For this example the channel that was used for the test is SYSTEM.DEF.SVRCONN.

DISPLAY CHSTATUS(SYSTEM.DEF.SVRCONN) ALL

To keep this technote from being too long, only a subset of the displayed attributes are shown:

# MQ C client "amqsputc.exe" using 7.5.0.0
AMQ8417: Display Channel Status details.
   CHANNEL(SYSTEM.DEF.SVRCONN)             CHLTYPE(SVRCONN)
   CONNAME(9.27.47.21)                     CURRENT
   MCASTAT(RUNNING)                        MCAUSER(user123)
   RAPPLTAG(s\c\Samples\Bin\amqsputc.exe)
   SSLRKEYS(0)                             STATUS(RUNNING)
   STOPREQ(NO)                             SUBSTATE(RECEIVE)
   CURSHCNV(1)                             MAXSHCNV(10)
   RVERSION(07050000)                      RPRODUCT(MQCC)

# MQ C client "amqsputc" using 7.1.0.2
AMQ8417: Display Channel Status details.
   CHANNEL(SYSTEM.DEF.SVRCONN)             CHLTYPE(SVRCONN)
   CONNAME(9.27.46.234)                    CURRENT
   RAPPLTAG(amqsputc)                      SSLCERTI( )
   STATUS(RUNNING)                         STOPREQ(NO)
   SUBSTATE(RECEIVE)                       CURSHCNV(1)
   MAXSHCNV(10)                            RVERSION(07010002)
   RPRODUCT(MQCC)

# MQ C client "amqsputc.exe" using 7.0.1.9
AMQ8417: Display Channel Status details.
   CHANNEL(SYSTEM.DEF.SVRCONN)             CHLTYPE(SVRCONN)
   CONNAME(9.27.47.212)                    CURRENT
   RAPPLTAG(ebSphere MQ\bin\amqsputc.exe)
   SSLRKEYS(0)                             STATUS(RUNNING)
   STOPREQ(NO)                             SUBSTATE(RECEIVE)
   CURSHCNV(1)                             MAXSHCNV(10)
   RVERSION(07000109)                      RPRODUCT(MQCC)

# MQ JMS client "JmsProducerLoop2" using 7.5.0.0
AMQ8417: Display Channel Status details.
   CHANNEL(SYSTEM.DEF.SVRCONN)             CHLTYPE(SVRCONN)
   CONNAME(9.27.47.212)                    CURRENT
   MCASTAT(RUNNING)                        MCAUSER(user123)
   MONCHL(OFF)                             MSGS(21)
   RAPPLTAG(JmsProducerLoop2)              SSLCERTI( )
   STATUS(RUNNING)                         STOPREQ(NO)
   SUBSTATE(RECEIVE)                       CURSHCNV(2)
   MAXSHCNV(10)                            RVERSION(07050000)
   RPRODUCT(MQJM)

[{"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0;7.5;7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

WebSphere MQ WMQ

Document Information

Modified date:
15 June 2018

UID

swg21620159