When communication between the service requester and service provider
uses MQ, the URI of the target is in a form that identifies the target as
a queue, and includes information to specify how the request and response
should be handled by MQ.

Syntax

>>-jms:/queue?-------------------------------------------------->
.-&----------------------------------------------.
V |
>----+-destination=queuename-+------------------+-+-+----------><
| '-@queumanagername-' |
+-persistence=message_persistence------------+
+-priority=message_priority------------------+
+-replyDestination=reply_queue---------------+
+-timeout=timeout----------------------------+
+-timeToLive=expiry_time---------------------+
'-targetService=string-----------------------'
CICS uses the following options; other Web service providers
may use further options that are not described here. CICS ignores any options
that it does not support and that are coded in the URI. However, the entire
URI is passed to the service provider. CICS is not sensitive to the case of
the option names. However, some other implementations that support this style
of URI are case-sensitive.
- destination=queuename [@queumanagername]
- queuename is the name of the input queue in the target
queue manager
- queuemanagername is the name of the target queue manager
- persistence=message_persistence
- Specify one of the following:
- 0
- Messages are not persistent.
- 1
- Messages are persistent.
- 2
- Persistence is defined by the default queue persistence.
If the option is not specified or is specified incorrectly,
the default queue persistence is be used.
- priority=message_priority
- Specifies the message priority as an integer in the range 0 to 99999999.
- replyDestination=reply_queue
- Specifies the queue to be used for the response message. If this option
is not specified, CICS® will use a dynamic queue for the response message.
You must define the reply queue in a QLOCAL object before using this option.
- timeout=timeout
- The timeout in milliseconds for which the service requester will wait
for a response. If a value of zero is specified, or if this option is omitted,
the request will not time out.
- timeToLive=expiry-time
- Specifies the expiry time for the request in milliseconds. If the option
is not specified or is specified incorrectly, the request will not expire.
- targetService=string
- Identifies the target service. If CICS is the service provider, then the
target service should be of the form '/string', as CICS will use this as the path when attempting
to match with URIMAP. If not specified, the value specified in TRIGDATA on
the input queue at the service provider is used.

This is an example of a URI for the MQ transport:

jms:/queue?destination=queue01@cics007&timeToLive=10&replyDestination=rqueue05&targetService=/myservice