Message Server Address Syntax

The syntax for specifying a message server address is as follows:

scheme://address_syntax

where the scheme and address_syntax are described in the folowing table.

Scheme Connection Service Description Syntax
mq jms
and
ssljms
The Message Queue Port Mapper at the specified host and port will handle the connection request, dynamically assigning a port based on the specified connection service. Once the port number is known, Message Queue makes the connection. [hostName][:port][/serviceName]
Defaults (for jms service only):
hostName = localhost
port = 7676
serviceName = jms
mqtcp jms Message Queue makes a direct tcp connection to the specified host and port to establish a connection. hostName:port/jms
mqssl ssljms Message Queue makes a direct, secure ssl connection to the specified host and port to establish a connection. hostName:port/ssljms
htttp httpjms Message Queue makes a direct HTTP connection to the specified Message Queue tunnel servlet URL. (The broker must be configured to access the tunnel servlet.) HTTPtunnelServletURL
htttps httpsjms Message Queue makes a direct HTTPS connection to the specified Message Queue tunnel servlet URL. (The broker must be configured to access the tunnel servlet.) HTTPStunnelServletURL

 

The following table shows how the message server address syntax applies in some typical cases.

Connection Service Broker Host Port Example Address
Unspecified Unspecified Unspecified Default
(mq://localHost:7676/jms)
Unspecified Specified Host Unspecified myBkrHost
(mq://myBkrHost:7676/jms)
Unspecified Unspecified Specified Portmapper Port 1012
(mq://localHost:1012/jms)
ssljms Local Host Default Portmapper Port mq://localHost:7676/ssljms
ssljms Specified Host Default Portmapper Port mq://myBkrHost:7676/ssljms
ssljms Specified Host Specified Portmapper Port mq://myBkrHost:1012/ssljms
jms Local Host Specified Service Port mqtcp://localhost:1032/jms
ssljms Specified Host Specified Service Port mqssl://myBkrHost:1034/ssljms
httpjms N/A N/A http://websrvr1:8085/imq/tunnel
httpsjms N/A N/A https://websrvr2:8090/imq/tunnel