Nachrichtenformate

Clientanwendungen, die für WebSphere Message Broker entwickelt werden, sollten den MQRFH2-Nachrichtenheader verwenden. Auf diese Weise können Anwendungen alle von WebSphere Message Broker bereitgestellten Funktionen nutzen.

Bestehende WebSphere MQ Publish/Subscribe-Anwendungen, die den MQRFH-Nachrichtenheader verwenden, werden ebenfalls von WebSphere Message Broker unterstützt, ihr Funktionsumfang ist jedoch auf die Funktionen von WebSphere MQ Publish/Subscribe begrenzt.

WebSphere MQ Publish/Subscribe unterstützt das MQRFH2-Format nicht. Clients, die mit WebSphere MQ Publish/Subscribe-Brokern verbunden werden, müssen das MQRFH-Format verwenden.

Clientanwendungen, die über Publish/Subscribe miteinander kommunizieren müssen, können dies jedoch unabhängig vom verwendeten Nachrichtenformat. WebSphere Message Broker stellt eine automatische Konvertierung zur Verfügung, um sicherzustellen, dass ein Subskribent Nachrichten im richtigen Format empfängt.

Die folgende Tabelle zeigt die Zuordnung zwischen funktional entsprechenden Feldern in den Nachrichtenheadern MQRFH und MQRFH2:

MQRFH-Feldname MQRFH2-Feldname
MQPSCommand Command
MQPSDelOpts DelOpt
MQPSPubOpts PubOpt
MQPSPubTime PubTime
MQPSQMgrName QMgrName
MQPSQName QName
MQPSRegOpts RegOpt
MQPSSeqNum SeqNum
MQPSTopic Topic

Alle in der Tabelle aufgeführten MQRFH2-Felder befinden sich in einem <psc>-Ordner.

Nicht in der Tabelle enthaltene Feldnamen haben keine gemeinsame Bedeutung oder sind nur in einem der beiden Headerformate gültig. Feldnamen, die vom jeweils anderen Format nicht erkannt werden oder für dieses nicht geeignet sind, werden nicht kopiert. Ein MQRFH kann beispielsweise folgenden Name-Wert-Bereich enthalten:
MQPSCommand Publish
MQPSPubOpts RetainPub
MQPSStreamName SAMPLE.BROKER.RESULTS.STREAM
MQPSTopic "Sport/Fußball/Status/Spielstand/Team1 Team2"
Dieser Bereich wird in folgenden MQRFH2-Ordner konvertiert:
<psc>
   <Command>Publish</Command>
<PubOpt>RetainPub</PubOpt>
<Topic>Sport/Soccer/State/LatestScore/Team1 Team2</Topic>
</psc>

Mit Hilfe dieser Zuordnungsregeln stellt WebSphere Message Broker sicher, dass MQRFH2-Veröffentlichungen weiterhin von MQRFH-Subskribenten und MQRFH-Veröffentlichungen weiterhin von MQRFH2-Subskribenten empfangen werden können.

MQRFH2-Subskribenten können Inhaltsfilter angeben, auch wenn das Thema, für das sie eine Subskription einrichten, von einem WebSphere MQ Publish/Subscribe-Client im MQRFH-Format veröffentlicht wird. Allerdings gibt es einige Einschränkungen bei der Kompatibilität. Auf diese Einschränkungen wird später in diesem Abschnitt eingegangen.

Die folgende Tabelle enthält eine Zusammenfassung der gültigen Optionen für Clients, die die unterschiedlichen Nachrichtenformate verwenden.

Nachricht

Optionsname

Optionswert

Unterstützung

Alle Anforderungen
(Client an Broker)

MQPSCommand

DeletePub
DeregPub
DeregSub
Publish
RegPub
RegSub
ReqUpdate

ja
ja1
ja
ja
ja1
ja
ja

MQMD.Format

MQFMT_PCF
MQFMT_RF_HEADER

nein
ja

MQMD.Report

MQRO_PAN
MQRO_NAN

ja
ja

MQMD.MsgType

MQMT_REQUEST
MQMT_DATAGRAM

ja
ja

MQMD.MsgId

 

ja

MQMD.CorrelId

 

ja4

MQMD.ReplyToQ

 

ja

MQMD.ReplyToQMgr

 

ja

MQPSStreamName

 

Präfix für Thema3

MQPSTopic

 

ja

Alle Anforderungen außer
Veröffentlichung löschen

MQPSQMgrName

 

ja

MQPSQName

 

ja

MQPSRegOpts

CorrelAsId

ja

Veröffentlichung löschen

MQPSDelOpts

Local

ja5

Publisher abmelden1

MQPSRegOpts

DeregAll

ja

Subskribent abmelden

MQPSRegOpts

DeregAll

ja

Veröffentlichen

MQMD-Felder

wie von MQPS festgelegt2

ja

MQPSRegOpts

Anon

ja7

Local

ja5

DirectReq

ja1

MQPSPubOpts

NoReg

ja1

RetainPub

ja (vom Publisher festgelegt)

IsRetainedPub

ja (vom Broker festgelegt)

OtherSubsOnly

ja

MQPSPubTime

 

ja

MQPSSeqNum

 

ja

MQPSStringData1

 

ja

MQPSIntData1

 

ja

Publisher anmelden1

MQPSRegOpts

Anon

ja7

Local

ja5

DirectReq

ja1

Subskribent anmelden

MQPSRegOpts

Anon

ja7

Local

ja5

NewPubsOnly

ja

PubOnReqOnly

ja

InclStreamName

nein3

InformIfRet

ja

Alle Antworten
(Broker an Client)

MQPSCompCode

 

neue Werte hinzugefügt6

MQPSReason

 

neue Werte hinzugefügt6

MQPSReasonText

 

neue Werte hinzugefügt6

MQPSCommand

 

Befehl, auf den dies
eine Antwort ist

Anmerkungen:
  1. Diese Option wird zu Migrationszwecken unterstützt.
  2. MQPS steht für WebSphere MQ Publish/Subscribe.
  3. Der Parameter mit dem Datenstromnamen wird dem Thema als Präfix vorangestellt. Der Datenstromname kann vom Namen der Warteschlange abgeleitet sein, wenn die Eigenschaft implicitStreamNaming des Veröffentlichungsknotens gesetzt ist.
  4. Die Clientidentität wird durch die Verkettung von WS-Manager-Name, Warteschlangenname und Korrelations-ID (optional, wenn die Korrelations-ID als Identitätsoption festgelegt ist) bestimmt. Die Anwendungs-ID lautet daher "MQPSQMgrName:MQPSQName[:correlId]". Falls diese Werte in einer Nachricht nicht enthalten sind, werden die von WebSphere MQ Publish/Subscribe festgelegten Standardwerte verwendet.
  5. Das Verhalten dieser Option variiert.
  6. Es wurden neue Werte hinzugefügt.
  7. Wird von WebSphere Message Broker ignoriert.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
aq19780_