Queue server adapter processing
The Queue server adapter is called DFHMASCQ and runs under the CMAU transaction. It is invoked only in complex flows and is therefore always invoked by a flow navigator. This server adapter handles the requests and responses for WebSphere® MQ-enabled target applications.
To use this server adapter, you must correctly configure the CICS® region to use the CICS-WebSphere MQ adapter. The CICS-WebSphere MQ adapter connects a CICS region to a WebSphere MQ queue manager, enabling CICS application programs such as DFHMASCQ to use the WebSphere MQ Interface (MQI).
The flow navigator passes COMMAND.INPUT and QUEUE.DATA BTS data-containers to the Queue server adapter. The COMMAND.INPUT data-container contains the application data that must be sent to the target application. The QUEUE.DATA data-container contains the details of the type of WebSphere MQ request that is required. The request is either an MQGET call or an MQPUT call.
DFHMASCQ retrieves the details of the local queue that is specified in the service flow from the service flow BTS data-containers to send a WebSphere MQ request to that local queue. The service flow project tools allows you to make three types of requests to WebSphere MQ:
- DATAGRAM
- REQUEST
If the service flow uses DATAGRAM, the Queue server adapter performs an MQPUT command and does not wait for a defined reply queue or a response to the MQPUT command. The WebSphere MQ-enabled application that is the target of the WebSphere MQ call might be the service requester that issued the original request or an application that performs some work as part of the server adapter processing. Whatever role the WebSphere MQ-enabled application plays, it does not have to issue any response to the server adapter. If the target application is the service requester, the flow navigator processes the MQPUT command as an early reply to the request.
If the service flow uses REQUEST, the Queue server adapter performs an MQPUT command and returns to the flow navigator. The flow navigator invokes the Queue server adapter again to perform an MQGET command to retrieve the response from the specified reply queue.