5.28.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 JMSFileService 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.acme.service.JMSVendorActiveMQ

vendor.sonicmq=com.acme.service.JMSVendorSonicMQ

vendor.tibcomq=com.acme.service.JMSVendorTibcoMQ

vendor.webspheremq=com.acme.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.
Default. 61616 for ActiveMQ.
Default. 2506 for SonicMQ.
Default. 7222 for TibcoMQ.
Default. 1414 for WebSphereMQ.

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 WebSphereMQ connection.

CIPHER-SUITE

value

Optional. Used by WebSphereMQ connection.

MESSAGE-PRIORITY

value

0 (lowest) to 9 (highest).
Default. 4.

MESSAGE-DELIVERY

*PERSISTENT

Default. *PERSISTENT.

*NONPERSISTENT

 

MESSAGE-TIME-TO-LIVE

value

Default. 0 milliseconds.
A value of 0 means keep forever.

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)