Home

 

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, 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.

  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.

 

Parent topic:

Putting and receiving data bags

pc15750_

 

Home