Oracle GlassFish Message Queue 4.4.2 Developer's Guide for C Clients

MQCreateMessage

The MQCreateMessage function creates a new message of type MQ_MESSAGE.


MQCreateMessage
                  (MQMessageHandle * messageHandle);

Return Value

MQStatus. See the MQStatusIsError() function for more information.

Parameters

messageHandle

Output parameter for the handle that references the newly created message.

Use the MQCreateMessage function to create a message that has a header and, optionally, properties, but which does not have a body. Such messages might be used by applications to signal events, which could be specified using header fields or message properties. This could improve performance because the message does not have a body and therefore there is no body to parse.