Wednesday, August 8, 2012

WebSphere MQ With Tomcat : JNDI Property Names


WebSphere MQ JNDI Property Names:

I searched across the web and I didn’t find a single site stating exact JNDI MQ option for setting SSLCipherSuite value. I made this entire list of properties which can be useful for providing wide range of options to MQConnectionFactoty.
WebSphere MQ (IBM MQ) has lot of properties which can be made available from JNDI (Context.XML) entries. IBM MQ uses very specific Names which need to be set in Context XML Resource Entry.
Sample Resource Entry in Context is as below:
<Resource
        CHAN="<Channel Name>"
        HOST="<HostName>"
        PORT="<portNumber>"
        QMGR="<queueManagerName>"
        .
        .
        auth="Container"
       description="MQ JMS Queue Connection Factory"
        factory="com.ibm.mq.jms.MQQueueConnectionFactoryFactory"
        name="jms/ConnectionFactory"
        type="com.ibm.mq.jms.MQQueueConnectionFactory"/>

Below is the list of properties and their meaning.
Property Name
Used For
Short Description
CHAN
Channel Name
1 through 20 ASCII characters
HOST
Host Name
A valid TCP/IP host name
PORT
Port Number
A valid TCP/IP port numbe
QMGR
Queue Manager Name
Queue Manager Name
VER
Version
String
DESC
Description
String
TRAN
Transport Type
BINDINGS, CLIENT, DIRECT, QUEUED
CID
Client ID
JMS client identifier
CCS
CCS ID
coded character set identifier
MNS
Map Style Name
String
RCX
Receive Exit
String
RCXI
Receive Exit Init
String
SCX
Security Exit
String
SCXI
Security Exit Init
String
SDX
Send Exit
String
SDXI
Send Exit Init
String
SCPHS
SSL Cipher Suite  value
Cipher suite to use for SSL connection
SPEER
SSL Peer Name
Distinguished name is used to check the identifying certificate presented by the server at connection time
SCRL
SSL Certificate Store
 list of zero or more Certificate Revocation List
HC
HDR Component list
String
MC
Message Comp list
String
CT
Connection Tag
String
CTO
Connection Options
String
SCC
Send Check Count
String
SCALD
Shared Conversation Allowed
String
SRC
SSL Reset Count
String
SFIPS
SSL Fips Required
String
SPAG
Synch Points All Gets
String
UCP
Use Connection Pooling
Optional set of connection pool settings
PINT
Polling Interval
The interval, in milliseconds, between scans of all receivers during asynchronous message delivery
PVER
Provider Version
String
WCFMT
Wild Card Format
String
MBS
Message Batch Size
String
FIQ
Fail If Quiesce
Whether applications return from a method call if the queue manager has entered a controlled failure.
LA
Local Address
Specifies the local server address
RINT
Rescan Interval
the interval in milliseconds between which a topic is scanned to look for messages that have been added to a topic out of order
TCM
Target Client Matching
String
AEX
Asynch Exception
String
CCDTRUL
CCDT URL
String

These properties are very useful while using websphere MQ with Tomcat. This will enable user to get rid of provider specific code in App.
This list doesn’t end here. I will add more properties, as and when I get to know them, I will also add the descriptions as I find them.
More questions? Post a comment. I will try to answer as soon as possible.

8 comments:

  1. Is there a way to configure connection pool here?

    ReplyDelete
  2. Jack, Sorry for late reply.
    UCP - User Connection Pooling.
    UCP="true" will set the connection pool.

    ReplyDelete
  3. How can I pass the Username & Password for authentication?

    Thanks

    ReplyDelete
    Replies
    1. Baasel, No you will not be able to pass UserId and Password in JNDI as they are required while creating Connection object from ConnectionFactory and JNDI just creates ConnectionFactory object (not Connection)

      Delete
  4. How to specify the Max & min connnections, time out values here..

    ReplyDelete
    Replies
    1. Those are indirect and hidden parameters which can be set.

      You need to set UCP (user connection pool)=true and set max & min connections

      Delete
  5. Thank you so much man. I've been desperately looking for SSL properties for very long time.

    ReplyDelete
  6. is there a way we can configure primary and standby MQ server connection here like in WAS so that if primary fails, connection would automatically switch to standby?

    ReplyDelete