Änderungen an der Schnittstelle für C-API- und C-Client-Runtime

• Neue Funktion: MQGetDestinationName()

  MQGetDestinationName (const MQDestinationHandle destinationHandle, MQString * destinationName);

  Verwenden Sie diese Funktion, um den Namen eines Ziels abzurufen. Der zurückgegebene Wert destinationName ist eine Kopie, die von der aufrufenden Komponente durch Aufruf der Funktion MQFreeString() freigegeben werden muss.

  Parameter

  destinationHandle

  Ein Handle für das Ziel, dessen Namen Sie ermitteln möchten.

  destinationName

  Der Ausgabeparameter für den Namen.

  Diese Funktion ist nützlich, wenn Sie das ReplyTo-Muster verwenden. Sie können mithilfe der Funktion MQGetMessageReplyTo ein Handle für das Ziel abrufen, an das die Nachricht gesendet werden soll. Anschließend können Sie über MQGetDestinationName den Namen dieses Ziels abrufen. Nach Abruf des Zielnamens können Sie die Nachrichtenverarbeitung basierend auf dem Namen durchführen.

• Neuer aufgelisteter Wert: MQ_MESSAGE

  Der neue MQMessageType, MQ_MESSAGE, erlaubt C-Clients den Austausch von JMS-Nachrichten vom Typ Message mit anderen Message Queue-Clients (sowohl C als auch Java):

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

  Der Typ MQ_MESSAGE identifiziert Nachrichten, die einen Header sowie Eigenschaften, jedoch keinen Nachrichtentext aufweisen. Sie verwenden die Funktion MQCreateMessage (), um eine Nachrichten von diesem Typ zu erstellen.

• Eine neue Verbindungseigenschaft, MQ_UPDATE_RELEASE_PROPERTY, welche die Update-Release-Version für die installierte Version von Message Queue angibt. Verwenden Sie die Funktion MQGetMetaData(), um Versionsinformationen abzurufen.