Sending and receiving PCF messages in a specified queue

Sending PCF messages to a specified queue

To send a message to a specified queue, the mqPutBag call converts the contents of the specified bag into a PCF message and sends the message to the specified queue. The contents of the bag are unchanged after the call.

As input to this call, you must supply:
  • An MQI connection handle.
  • An object handle for the queue on which the message is to be placed.
  • A message descriptor. For more information about the message descriptor, see MQMD - Message descriptor.
  • Put Message Options using the MQPMO structure. For more information about the MQPMO structure, see MQPMO - Put-message options.
  • The handle of the bag to be converted to a message.
    Note: If the bag contains an administration message and the mqAddInquiry call was used to insert values into the bag, the value of the MQIASY_COMMAND data item must be an INQUIRE command recognized by the MQAI.

For a full description of the mqPutBag call, see mqPutBag.

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 MQGMO - Get-message options.
  • Get Message Options using the MQGMO structure. For more information about the MQGMO structure, see MQMD - Message Descriptor.
  • The handle of the bag to contain the converted message.

For a full description of the mqGetBag call, see mqGetBag.