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

  1. Define an initiation queue. Use the following command:

    DEFINE
    QLOCAL('initiation_queue')
    DESCR('description')

    Start of changewhere 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.End of change
  2. For each local request queue, define a QLOCAL object. Use the following command:

    DEFINE
    QLOCAL('queuename')
    DESCR('description')
    PROCESS(processname)
    INITQ('initiation_queue')
    TRIGGER
    TRIGTYPE(FIRST)
    TRIGDATA('default_target_service')
    BOTHRESH(nnn)
    BOQNAME('requeuename')

    where:
    • 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.
    • Start of changeinitiation_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.End of change
    • 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.
  3. Define a PROCESS object that specifies the trigger process. Use the following command:

    DEFINE
    PROCESS(processname)
    APPLTYPE(CICS)
    APPLICID(CPIL)

    where:
    • processname is the name of the process, and must be the same as the name that is used when defining the request queues.


dfhws_mq_provider.html | Timestamp icon Last updated: Sunday, 4 June 2017