Receiving PCF messages from a specified queue
To receive a message from a specified queue, the mqGetBag call gets a PCF
message from a specified queue and converts the message data into a data bag.
As input to this call, you must supply:
- An MQI connection handle.
- An object handle of the queue from which the message is to be read.
- A message descriptor. Within the MQMD structure, the Format parameter
must be MQFMT_ADMIN, MQFMT_EVENT, or MQFMT_PCF.
Note:
If the message is received within a unit of work (that is, with the MQGMO_SYNCPOINT
option) and the message has an unsupported format, the unit of work can be
backed out. The message is then reinstated on the queue and can be retrieved
using the MQGET call instead of the mqGetBag call. For more information about
the message descriptor, see the WebSphere MQ Application Programming Reference.
- Get Message Options using the MQGMO structure. For more information about
the MQGMO structure, see the WebSphere MQ Application Programming Reference.
- The handle of the bag to contain the converted message.
For a full description of the mqGetBag call, see mqGetBag.