5.29.3 CONNECT
The CONNECT command is used to open a connection to the enterprise messaging system.
The currently available vendor implementations are ActiveMQ, SonicMQ, TibcoMQ and WebSphereMQ.
It is possible to create more vendor implementations by writing a Java class that implements the JMSVendor interface.
The JMSXMLBindService does a service properties lookup using the VENDOR keyword value to determine which Java class will be used to create the connection object.
vendor.activemq=com.lansa.service.JMSVendorActiveMQ
vendor.sonicmq=com.lansa.service.JMSVendorSonicMQ
vendor.tibcomq=com.lansa.service.JMSVendorTibcoMQ
vendor.webspheremq=com.lansa.service.JMSVendorMQSeries
Keyword values can also be passed to the CONNECT command by using a working list argument. The first column supplies the keyword name and the second column the keyword value.
The command keyword takes precedence over the working list keyword value entry.
Syntax:
|
Command |
Keyword |
Value |
Developer notes for Command/Keyword/Value |
|
CONNECT |
VENDOR |
value |
Mandatory. Message System Vendor. |
|
HOST |
value |
Mandatory. hostname or hostname:port. |
|
|
PORT |
value |
Optional. |
|
|
USER |
value |
Optional. |
|
|
PASSWORD |
value |
Optional. |
|
|
CLIENTID |
value |
Optional. |
|
|
QUEUE |
value |
Mandatory. |
|
|
REPLYTO |
*TEMPORARY |
Optional. Create and use a temporary reply queue. |
|
|
CHANNEL |
value |
Conditional. Required for WebSphereMQ connection. |
|
|
QUEUE-MANAGER |
value |
Optional. Used by WebSphere connection. |
|
|
CIPHER-SUITE |
value |
Optional. Used by WebSphereMQ connection. |
|
|
MESSAGE-PRIORITY |
value |
0 (lowest) to 9 (highest). |
|
|
MESSAGE-DELIVERY |
*PERSISTENT |
Default. *PERSISTENT. |
|
|
*NONPERSISTENT |
|
||
|
MESSAGE-TIME-TO-LIVE |
value |
Default. 0 milliseconds. |
|
|
SESSION-TRANSACTED |
*YES |
Default. *NO. |
|
|
*NO |
|
||
|
SESSION-ACKNOWLEDGE |
*AUTO |
Default. *AUTO. |
|
|
*CLIENT |
|
||
|
*DUPOK |
|
Example
CONNECT VENDOR(WEBSPHEREMQ) HOST(LOCALHOST) CHANNEL(USERAGENT.CHANNEL) QUEUE-MANAGER(USERAGENT.QUEUE.MANAGER) QUEUE(USERAGENT.QUEUE) SERVICE_LIST(KEYWRD,KEYVAL)
CONNECT VENDOR(ACTIVEMQ) HOST(LOCALHOST) QUEUE(QUEUE_1) SERVICE_LIST(KEYWRD,KEYVAL)