Eigenschaften der IBM MQ-Servicedefinition

Eigenschaften und Attribute für Servicedefinitionen können Sie bei der Erstellung oder Bearbeitung von Servicedefinitionen festlegen.

Einige Attribute sind nur verfügbar, wenn die Servicedefinition über einen bestimmten Bindungstyp oder ein bestimmtes Nachrichtenaustauschmuster verfügt. Klicken Sie auf die folgenden Links, um die Eigenschaften für die einzelnen Eigenschaftenseiten einer Servicedefinition anzuzeigen:

Für jedes Attribut wird kurz beschrieben, wann dessen Konfiguration erforderlich oder sinnvoll sein kann.

Seite 'Allgemein'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Allgemein im Dialog mit den Servicedefinitionseigenschaften festlegen können.

Attribut Beschreibung
Namespace Gibt den Namespace für den Service an. Es ist bereits ein temporärer Standardwert zugeordnet.
Name Ein eindeutiger Name für die neue Servicedefinition. Bei dem Servicedefinitionsnamen muss die Groß-/Kleinschreibung nicht beachtet werden, ein Servicedefinitionsname in Groß-/Kleinschreibung wird jedoch beibehalten.
Nachrichtenaustauschmuster Das Nachrichtenaustauschmuster beschreibt die Richtung der Nachrichten, die während des Aufrufs eines Service gesendet und empfangen werden. Es gibt zwei Auswahlmöglichkeiten:
  • Unidirektional bedeutet, dass eine Nachricht nur in eine Richtung gesendet wird.
  • Anforderung-Antwort bedeutet, dass eine Nachricht gesendet wird und eine Antwort empfangen wird.
Bindungstyp Gibt die Version der IBM® MQ-Servicedefinitionsspezifikation an.
Kommentar Geben Sie einen Kommentar an, um den Service in der WSDL-Datei mit Anmerkungen zu versehen.

Seite 'Operation'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Operation im Dialog mit den Servicedefinitionseigenschaften festlegen können. Jeder Servicedefinition ist nur eine Operation zugeordnet.

Attribut Beschreibung
Operationsname Gibt den Namen der Operation an. Diese Eigenschaft muss über einen Wert verfügen, damit eine Servicedefinition erstellt werden kann.
Aktion Wird vom Service-Provider verwendet, um Serviceanforderungen zu senden. Beispiel: Zulassen, dass mehrere Services mit einer einzelnen Zieladresse implementiert werden, sodass ein Service-Provider die Anforderungen, die an der Zieladresse eingehen, entsprechend senden kann.

Wenn der Bindungstyp MQ ist, ist für Aktion der Wert targetAction angegeben.

Kommentar Geben Sie einen Kommentar an, um die Operation in der WSDL-Datei mit Anmerkungen zu versehen.

Seite 'Eingabeziel'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Eingabeziel im Dialog mit den Servicedefinitionseigenschaften festlegen können. Die Eingabeseiten definieren die Details der Nachricht, die der Service erwartet, sowie das Ziel, aus dem sie abgerufen wird.

Attribut Beschreibung
Name des Eingabeziels Gibt den Namen der Zielwarteschlange oder des Zielthemas an, an die bzw. das die Anforderung gesendet wird. Beispiel:
Das Zielwarteschlangen- oder Zielthemenpartikel eines IBM MQ-IRI. Beispiel:

msg/queue/INS.QUOTE.REPLY
Name des Ziel-Warteschlangenmanagers Gibt den Namen des Zielwarteschlangenmanagers an.
Verbindungs-Warteschlangenmanager Gibt den Namen des Warteschlangenmanagers an, mit dem der anfordernde Service eine Verbindung herstellt. Dieses Attribut entspricht dem Parameter 'QmgrName', der in den Aufrufen MQCONN() und MQCONNX() verwendet wird.
Clientverbindungseigenschaften Die Clientverbindungseigenschaften geben detaillierte Bindungen an, die Informationen dazu enthalten können, wie ein Serviceanforderer an eine bestimmte Maschine oder einen bestimmten Kanal gebunden wird. Die Angabe von Clientbindungen und Kanalnamen kann in manchen Fällen hilfreich sein, es kann jedoch auch eine Einschränkung bedeuten, wenn der Service zu genau angegeben wird. Dieses Problem kann gelöst werden, indem die Menge der Bindungsinformationen, die in eine Servicedefinition integriert werden, minimiert wird und zugelassen wird, dass die zugrunde liegende Infrastruktur oder IBM MQ Nachrichten weiterleitet, wo dies möglich ist.
Kanaltabellenname Gibt den Namen der Clientkanaltabellendatei an, die für die Identifikation der Kanalverbindung verwendet wird.
  • Wenn das Attribut Kanaltabellenname nicht angegeben wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Kanaltabellenname ignoriert.
Kanaltabellenbibliothek Gibt den Pfad zu der Clientkanaltabelle an.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLLIB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
  • Wenn das Attribut Kanaltabellenname nicht angegeben wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
Clientkanal-Verbindungsname Gibt die Verbindungszeichenfolge an, die verwendet wird, wenn ein Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt. Für TCP/IP wird die Verbindung in Form eines Hostnamens angegeben, auf den eine Portnummer folgt. Beispiel:

OS2ROG3(1822)
Wenn die Portnummer nicht angegeben wird, wird der Standardwert 1414 verwendet.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Clientkanal-Verbindungsname ignoriert.
Clientkanalname Gibt den Kanal an, der verwendet wird, wenn ein IBM MQ-Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Clientkanalname ignoriert.
Clientkanal-Transporttyp Gibt den Transporttyp an, der verwendet wird, wenn ein IBM MQ-Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Transporttyp ignoriert.
Es können zwei verschiedene Werte ausgewählt werden:
  • TCP. Wird verwendet, um das TCP/IP-Transportprotokoll anzugeben. Dies ist der Standardwert.
  • LU62. Wird verwendet, um das LU6.2-Transportprotokoll anzugeben.

Seite 'Eingabenachrichtenschema'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Eingabenachrichtenschema im Dialog mit den Servicedefinitionseigenschaften festlegen können. Mit diesen Attributen kann das Schema für die Nachrichtennutzdaten definiert werden.

Attribut Beschreibung
Inbound data type (Typ der ankommenden Daten) Gibt den erwarteten Typ der ankommenden Daten an. Bei einfachen Typen kann dieser Datentyp mithilfe der integrierten XML-xsd-Typen wie xsd:string oder xsd:int modelliert werden. Bei komplexeren Typen kann ein Datentyp aus einer externen Datei importiert werden, indem die Importschemadatei und der Importnamensbereich für den Datentyp angegeben wird.
Importschemadatei Gibt die Schemadatei an, die importiert werden soll.
Importnamensbereich Gibt den Namensbereich an, der importiert werden soll.

Seite 'Eingabenachrichtenheader'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Eingabenachrichtenheader im Dialog mit den Servicedefinitionseigenschaften festlegen können. Die Eingabeseiten definieren die Details der Nachricht, die der Service erwartet, sowie das Ziel, aus dem sie abgerufen wird. Einige Eigenschaften gelten nur für Servicedefinitionen eines MQ-Bindungstyps.

Attribut Beschreibung
CCSID Gibt die ID des codierten Zeichensatzes an, die dem Feld CodedCharSetId in der MQMD-Struktur entspricht. Wenn dieser Wert nicht angegeben wird, verwenden der Serviceanforderer und der Service-Provider den Wert, der dem Zeichensatz der Nachrichtendaten entspricht.
Format Gibt den Formatnamen der Nachrichtendaten an. Diese Eigenschaft entspricht dem Formatfeld MQRFH2 oder dem Formatfeld MQMD, wenn kein MQRFH2-Header vorhanden ist. Der Wert muss eine Zeichenfolge mit 0 bis 8 Zeichen sein, die aus den Zeichen A-Z und 0-9 besteht.

Das Format kann auf einen beliebigen Wert gesetzt werden, solange dieser mit den in der Beschreibung zum Formatfeld angegebenen Richtlinien übereinstimmt.

Benutzereigenschaften Gibt die benutzerdefinierten Daten an, die in IBM MQ-Servicenachrichten übertragen werden. Die Werte müssen in dem Format angegeben werden, das für RFH2-Ordnerelemente zulässig ist, und zwar in einer Reihe von Triplets, die mithilfe einer XML-ähnlichen Syntax codiert werden. Beispiel:

<name dt="datatype">Wert</name>
Das Element dt="datatype" ist optional und wenn es weggelassen wird, wird es als Zeichenfolge behandelt, sodass Elemente wie folgt angegeben werden können:

<name>Wert</name>
Beispiel:

<myprop1>Wert1</myProp1><myprop2>Wert2</myProp2><myprop3 dt="i4">99</myProp3>
Weitere Informationen zu den zulässigen Datentypen und zur Formatierung finden Sie unter NameValueData (MQCHARn) in der IBM Knowledge Center. Es wird nicht empfohlen, sicherheitsbezogene Eigenschaften wie Benutzer-IDs oder Kennwörter einzufügen.
Nachrichtenart Gibt den Typ der Nachricht an, die gesendet wird. Diese Eigenschaft entspricht dem Wert für MsgType in der MQMD-Struktur. Es gibt fünf gültige Werte:
  • Nicht angegeben, was bedeutet, dass kein Wert festgelegt ist, deshalb wird der Wert dem Attribut Nachrichtenaustauschmuster entnommen. Dies ist der Standardwert.
  • Anforderung, was bedeutet, dass die Nachricht eine Antwort erfordert. Dieser Wert gibt an, dass der Service ein Nachrichtenaustauschmuster vom Typ 'Anforderung-Antwort' verwendet.
  • Beantworten, was bedeutet, dass die Nachricht eine Antwort auf eine Anforderung darstellt.
  • Bericht, was bedeutet, dass die Nachricht einen Bericht darstellt.
  • Datagramm, was bedeutet, dass der Service ein unidirektionaler Nachrichtenaustausch ist und dass es keine Antwort geben wird.
Wenn kein Wert angegeben ist, wird der Wert entsprechend dem Nachrichtenaustauschmuster festgelegt.
Permanenz Gibt an, ob die Nachricht permanent ist oder nicht. Dieses Attribut entspricht dem Feld Persistence in der MQMD-Struktur. Es gibt drei gültige Werte:
  • Nicht permanent, was bedeutet, dass die Nachrichten nicht permanent sind.
  • Permanent, was bedeutet, dass die Nachrichten permanent sind.
  • Warteschlangenstandard, was bedeutet, dass der Warteschlangenmanager die Nachrichtenpersistenz aus der Definition des Ziels bestimmt, in das die Nachricht eingereiht wird. Dies ist der Standardwert.
Nachrichten-ID Gibt die Nachrichten-ID an, die dem Feld MsgId in der MQMD-Struktur entspricht.

Mithilfe der Nachrichten-ID können bestimmte spezialisierte IBM MQ-Anwendungen als Services beschrieben werden (z. B. Anwendungen, die eine Eingabewarteschlange gemeinsam nutzen und die Nachrichten, die für sie bestimmt sind, auf Basis eines vordefinierten Nachrichten-ID-Werts auswählen). Vordefinierte Nachrichten-IDs in Servicedefinitionen können zu Problemen führen, wenn z. B. ein Nachrichtenaustauschmuster vom Typ 'Anforderung-Antwort' die Nachrichten-ID der Anforderung zurückgibt.

Die Nachrichten-ID kann eine Zeichenfolge oder ein binärer Wert sein. Binäre Werte müssen Zeichenfolgen mit bis zu 24 Paaren aus Hexadezimalwerten mit zwei Zeichen sein.

Klicken Sie auf Bearbeiten, um einen Dialog zu öffnen und einen Wert als Text oder Bytes einzugeben.

Korrelations-ID Gibt die Korrelations-ID an, die dem Feld 'CorrelId' in der MQMD-Struktur entspricht. Die Korrelations-ID kann eine Zeichenfolge oder ein binärer Wert sein. Binäre Werte müssen Zeichenfolgen mit bis zu 24 Paaren aus Hexadezimalwerten mit zwei Zeichen sein.

Klicken Sie auf Bearbeiten, um einen Dialog zu öffnen und einen Wert als Text oder Bytes einzugeben.

Verfall Gibt die Lebensdauer einer Nachricht an. Dieser Wert muss eine ganze Zahl mit Vorzeichen sein und wird in Zehntelsekunden gemessen. Der Wertebereich für Verfall liegt zwischen 1 und 2.147.483.647.

Der Sonderwert Uneingeschränkt wird verwendet, um anzugeben, dass die Nachricht nicht verfällt. Der Wert -1 wird in die WSDL-Datei geschrieben.

Der Wert Nicht angegeben bedeutet, dass kein Wert in die WSDL-Datei geschrieben wird. Dies ist der Standardwert.

Priorität Gibt die Priorität an, die der Nachricht zugeordnet ist, und entspricht dem Feld Priority in der MQMD-Struktur. Der Wert muss als ganze Zahl zwischen 0 und 9 angegeben werden, wobei 0 für die niedrigste Priorität und 9 für die höchste Priorität steht.

Der Sonderwert Uneingeschränkt wird verwendet, um anzugeben, dass die Nachrichtenpriorität der Definition der ersten Warteschlange entnommen wird, in die die Nachricht eingereiht wird. Der Wert -1 wird in die WSDL-Datei geschrieben.

Der Wert Nicht angegeben bedeutet, dass kein Wert in die WSDL-Datei geschrieben wird. Dies ist der Standardwert.

Codierung Gibt die numerische Codierung von Nachrichtendaten an, die dem Feld Encoding in der MQMD-Struktur entspricht:
  • Ganzzahl ermöglicht die Auswahl von 'Normal' oder 'Umgekehrt'
  • Dezimalzahl ermöglicht die Auswahl von 'Normal' oder 'Umgekehrt'
  • Gleitkommazahl ermöglicht die Auswahl von 'Normal', 'Umgekehrt' oder 'S390'
  • Mnemonisch gibt das mnemonische Zeichen mit drei Zeichen an, das auf den anderen ausgewählten Werten basiert. R = Umgekehrt, N = Normal und 3 = S390.
  • Wert gibt den numerischen Wert der ausgewählten Optionen und des mnemonischen Zeichens an.
Berichtsoptionen Gibt an, wie die Nachrichten-ID und die Korrelations-ID in der Antwortnachricht oder der Fehlernachricht vom Service-Provider festgelegt werden. Diese Eigenschaft entspricht dem Feld 'Report' in der MQMD-Struktur. Es gibt vier gültige Werte:
  • Neue Nachrichten-ID gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht eine neue Nachrichten-ID für den Bericht oder die Antwortnachricht generiert wird.
  • Nachrichten-ID übergeben gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Nachrichten-ID dieser Nachricht in die Nachrichten-ID des Berichts oder der Antwortnachricht kopiert wird.
  • Nachrichten-ID in Korrelations-ID kopieren gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Nachrichten-ID dieser Nachricht in die Korrelations-ID des Berichts oder der Antwortnachricht kopiert wird.
  • Korrelations-ID übergeben gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Korrelations-ID dieser Nachricht in die Korrelations-ID des Berichts oder der Antwortnachricht kopiert wird.

Seite 'Ausgabeziel'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Ausgabeziel im Dialog mit den Servicedefinitionseigenschaften festlegen können. Die Ausgabeseiten definieren die Details der Nachricht, die der Service als Antwort auf die Eingabenachricht sendet, sowie das Ziel, in das sie eingereiht wird. Der Name des Ausgabeziels muss als Präfix 'msg/queue/' für Warteschlangen oder 'msg/topic/' für Themen enthalten.

Attribut Beschreibung
Name des Ausgabeziels Gibt den Namen der Zielwarteschlange oder des Zielthemas an, an die bzw. das die Antwortnachricht gesendet wird, entspricht den Feldern 'ReplyToQ' und 'ReplyToQMgr' der MQMD-Struktur. Der Name des Ziels muss wie das Zielwarteschlangen- oder Zielthemenpartikel eines IBM MQ-URI angegeben werden. Beispiel:

msg/queue/INS.QUOTE.REPLY
Name des Ziel-Warteschlangenmanagers Gibt den Namen des Zielwarteschlangenmanagers an.
Verbindungs-Warteschlangenmanager Gibt den Namen des Warteschlangenmanagers an, mit dem der anfordernde Service eine Verbindung herstellt. Dieses Attribut entspricht dem Parameter 'QmgrName', der in den Aufrufen MQCONN() und MQCONNX() verwendet wird.
Clientverbindungseigenschaften Die Clientverbindungseigenschaften geben detaillierte Bindungen an, die Informationen dazu enthalten können, wie ein Serviceanforderer an eine bestimmte Maschine oder einen bestimmten Kanal gebunden wird. Die Angabe von Clientbindungen und Kanalnamen kann in manchen Fällen hilfreich sein, es kann jedoch auch eine Einschränkung bedeuten, wenn der Service zu genau angegeben wird. Dieses Problem kann gelöst werden, indem die Menge der Bindungsinformationen, die in eine Servicedefinition integriert werden, minimiert wird und zugelassen wird, dass die zugrunde liegende Infrastruktur oder IBM MQ Nachrichten weiterleitet, wo dies möglich ist.
Kanaltabellenname Gibt den Namen der Clientkanaltabellendatei an, die für die Identifikation der Kanalverbindung verwendet wird.
  • Wenn das Attribut Kanaltabellenname nicht angegeben wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Kanaltabellenname ignoriert.
Kanaltabellenbibliothek Gibt den Pfad zu der Clientkanaltabelle an.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLLIB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
  • Wenn das Attribut Kanaltabellenname nicht angegeben wird, wird das Attribut Kanaltabellenbibliothek ignoriert.
Clientkanalname Gibt die Verbindungszeichenfolge an, die verwendet wird, wenn ein Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt. Für TCP/IP wird die Verbindung in Form eines Hostnamens angegeben, auf den eine Portnummer folgt. Beispiel:

OS2ROG3(1822)
Wenn die Portnummer nicht angegeben wird, wird der Standardwert 1414 verwendet.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Clientkanal-Verbindungsname ignoriert.
Clientkanal-Verbindungsname Gibt den Kanal an, der verwendet wird, wenn ein IBM MQ-Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Clientkanalname ignoriert.
Clientkanal-Transporttyp Gibt den Transporttyp an, der verwendet wird, wenn ein IBM MQ-Serviceanforderer eine IBM MQ MQI-Clientbindungsverbindung herstellt.
  • Wenn der Clientkanal-Verbindungsname angegeben wird, müssen auch der Clientkanalname und der Clientkanal-Transporttyp angegeben werden.
  • Wenn eine der Umgebungsvariablen MQSERVER und MQCHLTAB in der Umgebung festgelegt ist, in der die Clientanwendung ausgeführt wird, wird das Attribut Transporttyp ignoriert.
Es können zwei verschiedene Werte ausgewählt werden:
  • TCP. Wird verwendet, um das TCP/IP-Transportprotokoll anzugeben. Dies ist der Standardwert.
  • LU62. Wird verwendet, um das LU6.2-Transportprotokoll anzugeben.

Seite 'Ausgabenachrichtenschema'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Ausgabenachrichtenschema im Dialog mit den Servicedefinitionseigenschaften festlegen können. Mit diesen Attributen kann das Schema für die Nachrichtennutzdaten definiert werden.

Attribut Beschreibung
Typ der abgehenden Daten Gibt den erwarteten Typ der abgehenden Daten an.
Importschemadatei Gibt die Schemadatei an, die importiert werden soll.
Importnamensbereich Gibt den Namensbereich an, der importiert werden soll.

Seite 'Ausgabenachrichtenheader'

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie auf der Seite Ausgabenachrichtenheader im Dialog mit den Servicedefinitionseigenschaften festlegen können. Die Ausgabeseiten definieren die Details der Nachricht, die der Service als Antwort auf die Eingabenachricht sendet, sowie das Ziel, in das sie eingereiht wird. Einige Eigenschaften gelten nur für Servicedefinitionen eines MQ-Bindungstyps.

Attribut Beschreibung
CCSID Gibt die ID des codierten Zeichensatzes an, die dem Feld CodedCharSetId in der MQMD-Struktur entspricht. Wenn dieser Wert nicht angegeben wird, verwenden der Serviceanforderer und der Service-Provider den Wert, der dem Zeichensatz der Nachrichtendaten entspricht.
Format Gibt den Formatnamen der Nachrichtendaten an. Diese Eigenschaft entspricht dem Formatfeld MQRFH2 oder dem Formatfeld MQMD, wenn kein MQRFH2-Header vorhanden ist. Der Wert muss eine Zeichenfolge mit 0 bis 8 Zeichen sein, die aus den Zeichen A-Z und 0-9 besteht.

Das Format kann auf einen beliebigen Wert gesetzt werden, solange dieser mit den in der Beschreibung zum Formatfeld angegebenen Richtlinien übereinstimmt.

Benutzereigenschaften Gibt die benutzerdefinierten Daten an, die in IBM MQ-Servicenachrichten übertragen werden. Die Werte müssen in dem Format angegeben werden, das für RFH2-Ordnerelemente zulässig ist, und zwar in einer Reihe von Triplets, die mithilfe einer XML-ähnlichen Syntax codiert werden. Beispiel:

<name dt="datatype">Wert</name>
Das Element dt="datatype" ist optional und wenn es weggelassen wird, wird es als Zeichenfolge behandelt, sodass Elemente wie folgt angegeben werden können:

<name>Wert</name>
Beispiel:

<myprop1>Wert1</myProp1><myprop2>Wert2</myProp2><myprop3 dt="i4">99</myProp3>
Weitere Informationen zu den zulässigen Datentypen und zur Formatierung finden Sie unter NameValueData (MQCHARn) in der IBM Knowledge Center. Es wird nicht empfohlen, sicherheitsbezogene Eigenschaften wie Benutzer-IDs oder Kennwörter einzufügen.
Nachrichtenart Gibt den Typ der Nachricht an, die gesendet wird. Diese Eigenschaft entspricht dem Wert für MsgType in der MQMD-Struktur. Es gibt fünf gültige Werte:
  • Nicht angegeben, was bedeutet, dass kein Wert festgelegt ist, deshalb wird der Wert dem Attribut Nachrichtenaustauschmuster entnommen. Dies ist der Standardwert.
  • Anforderung, was bedeutet, dass die Nachricht eine Antwort erfordert. Dieser Wert gibt an, dass der Service ein Nachrichtenaustauschmuster vom Typ 'Anforderung-Antwort' verwendet.
  • Beantworten, was bedeutet, dass die Nachricht eine Antwort auf eine Anforderung darstellt.
  • Bericht, was bedeutet, dass die Nachricht einen Bericht darstellt.
  • Datagramm, was bedeutet, dass der Service ein unidirektionaler Nachrichtenaustausch ist und dass es keine Antwort geben wird.
Wenn kein Wert angegeben ist, wird der Wert entsprechend dem Nachrichtenaustauschmuster festgelegt.
Permanenz Gibt an, ob die Nachricht permanent ist oder nicht. Dieses Attribut entspricht dem Feld Persistence in der MQMD-Struktur. Es gibt drei gültige Werte:
  • Nicht permanent, was bedeutet, dass die Nachrichten nicht permanent sind.
  • Permanent, was bedeutet, dass die Nachrichten permanent sind.
  • Warteschlangenstandard, was bedeutet, dass der Warteschlangenmanager die Nachrichtenpersistenz aus der Definition des Ziels bestimmt, in das die Nachricht eingereiht wird. Dies ist der Standardwert.
Nachrichten-ID Gibt die Nachrichten-ID an, die dem Feld MsgId in der MQMD-Struktur entspricht.

Mithilfe der Nachrichten-ID können bestimmte spezialisierte IBM MQ-Anwendungen als Services beschrieben werden (z. B. Anwendungen, die eine Eingabewarteschlange gemeinsam nutzen und die Nachrichten, die für sie bestimmt sind, auf Basis eines vordefinierten Nachrichten-ID-Werts auswählen). Vordefinierte Nachrichten-IDs in Servicedefinitionen können zu Problemen führen, wenn z. B. ein Nachrichtenaustauschmuster vom Typ 'Anforderung-Antwort' die Nachrichten-ID der Anforderung zurückgibt.

Die Nachrichten-ID kann eine Zeichenfolge oder ein binärer Wert sein. Binäre Werte müssen Zeichenfolgen mit bis zu 24 Paaren aus Hexadezimalwerten mit zwei Zeichen sein.

Klicken Sie auf Bearbeiten, um einen Dialog zu öffnen und einen Wert als Text oder Bytes einzugeben.

Korrelations-ID Gibt die Korrelations-ID an, die dem Feld 'CorrelId' in der MQMD-Struktur entspricht. Die Korrelations-ID kann eine Zeichenfolge oder ein binärer Wert sein. Binäre Werte müssen Zeichenfolgen mit bis zu 24 Paaren aus Hexadezimalwerten mit zwei Zeichen sein.

Klicken Sie auf Bearbeiten, um einen Dialog zu öffnen und einen Wert als Text oder Bytes einzugeben.

Verfall Gibt die Lebensdauer einer Nachricht an. Dieser Wert muss eine ganze Zahl mit Vorzeichen sein und wird in Zehntelsekunden gemessen. Der Wertebereich für Verfall liegt zwischen 1 und 2.147.483.647.

Der Sonderwert Uneingeschränkt wird verwendet, um anzugeben, dass die Nachricht nicht verfällt. Der Wert -1 wird in die WSDL-Datei geschrieben.

Der Wert Nicht angegeben bedeutet, dass kein Wert in die WSDL-Datei geschrieben wird. Dies ist der Standardwert.

Priorität Gibt die Priorität an, die der Nachricht zugeordnet ist, und entspricht dem Feld 'Priority' in der MQMD-Struktur. Der Wert muss als ganze Zahl zwischen 0 und 9 angegeben werden, wobei 0 für die niedrigste Priorität und 9 für die höchste Priorität steht.

Der Sonderwert Uneingeschränkt wird verwendet, um anzugeben, dass die Nachrichtenpriorität der Definition der ersten Warteschlange entnommen wird, in die die Nachricht eingereiht wird. Der Wert -1 wird in die WSDL-Datei geschrieben.

Der Wert Nicht angegeben bedeutet, dass kein Wert in die WSDL-Datei geschrieben wird. Dies ist der Standardwert.

Codierung Gibt die numerische Codierung von Nachrichtendaten an, die dem Feld Encoding in der MQMD-Struktur entspricht:
  • Ganzzahl ermöglicht die Auswahl von 'Normal' oder 'Umgekehrt'
  • Dezimalzahl ermöglicht die Auswahl von 'Normal' oder 'Umgekehrt'
  • Gleitkommazahl ermöglicht die Auswahl von 'Normal', 'Umgekehrt' oder 'S390'
  • Mnemonisch gibt das mnemonische Zeichen mit drei Zeichen an, das auf den anderen ausgewählten Werten basiert. R = Umgekehrt, N = Normal und 3 = S390.
  • Wert gibt den numerischen Wert der ausgewählten Optionen und des mnemonischen Zeichens an.
Berichtsoptionen Gibt an, wie die Nachrichten-ID und die Korrelations-ID in der Antwortnachricht oder der Fehlernachricht vom Service-Provider festgelegt werden. Diese Eigenschaft entspricht dem Feld 'Report' in der MQMD-Struktur. Es gibt vier gültige Werte:
  • Neue Nachrichten-ID gibt an, dass bei der Generierung von Berichten oder Antworten als Ergebnis dieser Nachricht eine neue Nachrichten-ID für den Bericht oder die Antwortnachricht generiert wird.
  • Nachrichten-ID übergeben gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Nachrichten-ID dieser Nachricht in die Nachrichten-ID des Berichts oder der Antwortnachricht kopiert wird.
  • Nachrichten-ID in Korrelations-ID kopieren gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Nachrichten-ID dieser Nachricht in die Korrelations-ID des Berichts oder der Antwortnachricht kopiert wird.
  • Korrelations-ID übergeben gibt an, dass bei der Generierung eines Berichts oder einer Antwort als Ergebnis dieser Nachricht die Korrelations-ID dieser Nachricht in die Korrelations-ID des Berichts oder der Antwortnachricht kopiert wird.