Interface Changes to the C-API and C Client Runtime

Changes to the C-API were introduced with Release 3.7: they include a new function, a new message type, and a new connection property.

• New function: MQGetDestinationName()

  MQGetDestinationName (const MQDestinationHandle destinationHandle, MQString * destinationName);

  Use this function to get the name of a destination. The returned destinationName is a copy that the caller is responsible for freeing by calling the MQFreeString() function.

  Parameters

  destinationHandle

  A handle to the destination whose name you want to know.

  destinationName

  The output parameter for the name.

  This function is useful when using the reply-to pattern. You can use the MQGetMessageReplyTo function to obtain a handle to the destination where the message should be sent. You can then use the MQGetDestinationName to get the name of that destination. Having obtained the destination name, you can do message processing based on the name.

• New enumerated value: MQ_MESSAGE

  The new MQMessageType, MQ_MESSAGE, allows C clients to exchange JMS messages of type Message with other Message Queue clients (both C and Java):

  typedef enum _MQMessageType {MQ_TEXT_MESSAGE = 0, MQ_BYTES_MESSAGE = 1, MQ_MESSAGE = 3, MQ_UNSUPPORTED_MESSAGE = 2} MQMessageType;

  The MQ_MESSAGE type identifies messages that have a header and properties but no message body. You use the MQCreateMessage() function to create a message of this type.

• A new connection property, MQ_UPDATE_RELEASE_PROPERTY, that specifies the update release version for the installed version of Message Queue. Use the MQGetMetaData() function to obtain version information.