The URI for the MQ transport

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.

Start of change

Syntax

Read syntax diagramSkip visual syntax diagram
>>-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.
End of change
This is an example of a URI for the MQ transport:Start of change
jms:/queue?destination=queue01@cics007&timeToLive=10&replyDestination=rqueue05&targetService=/myservice
End of change