Sun GlassFish Message Queue 4.4 Developer's Guide for C Clients


The MQCreateMessage function creates a new message of type MQ_MESSAGE.

                  (MQMessageHandle * messageHandle);

Return Value

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



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.