MQ Send and Receive Processing

The platform server can read records from a message queue or write records to a message queue.

When the platform server processes a message queue, the message queue journals the request. The platform server does not support SYNCPOINT processing; therefore, large amounts of data cannot be sent to or read from the message queue. When a file transfer request fails, the platform server issues an MQ BACKOUT request, which causes the queue contents to revert to the state before the file transfer starts.

The platform server can send or receive data from message queues. Likewise, the platform server can initiate a request to another platform server for z/OS to process data from a message queue.

Note: Only platform servers for z/OS support message queues. If you send an MQ request to a platform server that does not support message queue, the results are unpredictable.

Examples

The following examples are sample platform server send and receive processing:

Example 1:

PROCESS MQSEND,TRANSFER,SEND
	LF=$MQ:MQ1:FUSION.MESSAGE.QUEUE1
	RF=C:\temp\mqdata

This example sends the contents of the message queue defined by the LF parameter to a remote node where the data is saved as a file.

Example 2:

PROCESS MQRECV,TRANSFER,RECEIVE
	LF=$MQ:MQ1:FUSION.MESSAGE.QUEUE1
	RF=C:\temp\mqdata

This example receives the remote file c:\temp\mqdata, and writes the data to the message queue defined by the LF parameter.

Example 3:

PROCESS MQSEND,TRANSFER,SEND
	LF=PROD.ZOS.DATA
 RF=$MQ:MQ1:FUSION.MESSAGE.QUEUE1

This example sends the contents of thePROD.ZOS.DATA file to the message queue on the remote node defined by the RF parameter.

Note: In this case, the remote node must be a platform server for z/OS with MQ support.

Example 4:

PROCESS MQRECV,TRANSFER,RECEIVE
	LF=PROD.ZOS.DATA
 RF=$MQ:MQ1:FUSION.MESSAGE.QUEUE1

This example receives message queue data from the remote node, and saves the data in the PROD.ZOS.DATA file.

Note: In this case, the remote node must be a platform server for z/OS with MQ support.