Defining local queues in a service provider
To use the WebSphere® MQ transport in a service provider, you must define one or more local queues that store request messages until they are processed, and one trigger process that specifies the CICS® transaction that will process the request messages.
Procedure
- Define an initiation queue. Use the following
command:
DEFINE
QLOCAL('initiation_queue')
DESCR('description')
where initiation_queue is the same as the value specified for the QNAME
attribute of the installed MQMONITOR resource definition for the CICS region, or the value specified for the INITQNAME attribute of the installed MQCONN
resource definition.
- For each local request queue, define a QLOCAL object. Use the following command:
DEFINE
where:
QLOCAL('queuename')
DESCR('description')
PROCESS(processname)
INITQ('initiation_queue')
TRIGGER
TRIGTYPE(FIRST)
TRIGDATA('default_target_service')
BOTHRESH(nnn)
BOQNAME('requeuename')- queuename is the local queue name.
- processname is the name of the process instance that identifies the application started by the queue manager when a trigger event occurs. Specify the same name on each QLOCAL object.
initiation_queue is the name of the
initiation queue to be used; for example, the initiation queue specified in the QNAME attribute of
the installed MQMONITOR resource definition for the CICS
region.
- default_target_service is the default target service to be used if a service is not specified on the request. The target service is of the form '/string' and is used to match the path of a URIMAP definition; for example, '/SOAP/test/test1'. The first character must be '/' .
- nnn is the number of retries that are attempted.
- requeuename is the name of the queue to which failed messages are sent.
- Define a PROCESS object that specifies the trigger process. Use the following command:
DEFINE
where:
PROCESS(processname)
APPLTYPE(CICS)
APPLICID(CPIL)- processname is the name of the process, and must be the same as the name that is used when defining the request queues.
Working with initiation queues
You can inquire on the name of the initiation queue with these interfaces:
CICS Explorer®
Use the Name attribute in the MQ Initiation Queues view.
You can inquire on the name of the initiation queue with these interfaces:
CICS Explorer®Use the Name attribute in the MQ Initiation Queues view.
dfhws_mq_provider.html |
Last updated: Sunday, 4 June 2017