Specifying the URI

 

A web service is specified using a Universal Resource Identifier (URI). This section specifies the URI format that is supported in WebSphere MQ transport for SOAP. This URI format permits a comprehensive degree of control over SOAP/WebSphere MQ specific parameters and options when accessing target services. This format is compatible with WebSphere Application Server (WAS) and with CICS facilitating the integration of WebSphere MQ with both those products provided that the prerequisite APARs have been applied. These APARs are listed in Interoperability.

The URI syntax is as follows:

jms:/queue?name=value&name=value...

where name is a parameter name and value is an appropriate value, and the name=value element can be repeated any number of times with the second and subsequent occurrences being preceded by an ampersand (&).

Parameter names and values are listed below. Parameter names are case sensitive, as are names of WebSphere MQ objects. If any parameter is specified more than once, the final occurrence of the parameter takes effect. This allows client applications to override parameter values by appending to the URI. If any additional unrecognised parameters are included, they are ignored.

If you store a URI in an XML string, represent the ampersand character as "&". Similarly, if a URI is coded in a script, take care to escape characters such as & which would otherwise be interpreted by the shell.

Examples of URIs are given in Sample URIs.