Sun Java System Message Queue 4.3 Developer's Guide for C Clients

MQCreateTextMessage

The MQCreatesTextMessage function creates a text message and passes a handle to it back to you.


MQCreateTextMessage( MQMessageHandle * messageHandle);

Return Value

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

Parameters

messageHandle

Output parameter for the handle to the new, empty message.

After you obtain the handle to a text message, you can use this handle to define its content with the MQSetBytesMessageBytesMQSetStringProperty function, to set its headers with the MQSetMessageHeaders function, and to set its properties with the MQSetMessageProperties() function.