WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

CICSRequest-Knoten

Verwenden Sie den CICSRequest-Knoten zum Aufrufen externer CICS Transaction Server for z/OS-Programme über das TCP/IP-basierte Protokoll IP InterCommunications (IPIC).

Zweck

Über den CICSRequest-Knoten können Sie WebSphere Message Broker mit CICS-Anwendungen verbinden. Der CICSRequest-Knoten kommuniziert mit CICS, indem er DPL-Anforderungen (Distributed Program Link) über das TCP/IP-basierte Protokoll IP InterCommunications (IPIC) sendet. Sie können einen Nachrichtenfluss erstellen, der einen CICSRequest-Knoten enthält, der eine CICS-Anwendung in einer Zielregion aufruft. Der CICSRequest-Knoten kann von einem Nachrichtenfluss, der auf einer beliebigen Brokerplattform implementiert ist, verwendet werden. Der CICSRequest-Knoten unterstützt CICS Transaction Server for z/OS Version 3.2 und höher.

CICSRequest-Knoten in einem Nachrichtenfluss verwenden

Eine mögliche Verwendung des CICSRequest-Knotens besteht darin, eine Verbindung mit einer CICS-Anwendung herzustellen, indem Sie eine synchrone Nachrichtenflussvariante verwenden. Sie können eine solche Verbindung herstellen, indem Sie folgenden Nachrichtenfluss erstellen:

Sie können eine solche Verbindung herstellen, indem Sie folgenden Nachrichtenfluss erstellen: Das Diagramm zeigt, wie Sie über einen CICSRequest-Knoten eine Verbindung mit einer CICS Transaction Server for z/OS-Anwendung herstellen können.

Die Unterstützung des CICSRequest-Knotens in WebSphere Message Broker ermöglicht die direkte Kommunikation mit CICS (zweischichtige Verbindung), indem DPL-Anforderungen (Distributed Program Link) über das TCP/IP-basierte Protokoll IPIC gesendet werden, oder die Kommunikation mit CICS über CICS Transaction Gateway for Multiplatforms (dreischichtige Verbindung). Eine allgemeine Übersicht über die zweischichtigen und dreischichtigen Verbindungsmodelle finden Sie im Abschnitt CICS Transaction Server for z/OS - Übersicht, während die Abschnitte Zweischichtige Konnektivität zu CICS Transaction Server for z/OS und Dreischichtige Konnektivität zu CICS Transaction Server for z/OS detailliertere Informationen zu den Konzepten enthalten.

Sie können im CICSRequest-Knoten entweder eine Kommunikationsbereichsdatenstruktur oder eine Kanaldatenstruktur als Eingabe zum Herstellen einer Verbindung zu CICS-Programmen angeben. Die als Eingabe angegebene Datenstruktur gibt dieselbe Datenstruktur als Ausgabe zurück. Kanäle sind eine vorteilhafte Alternative zu Kommunikationsbereichen, da die maximale Größe der Kommunikationsbereiche von 32767 Byte für sie nicht gilt und sie größere Flexibilität bei den Eingabe- und Ausgabedatenstrukturen ermöglichen. Weitere Informationen zur Verwendung einer Kommunikationsbereichs- oder Kanaldatenstruktur finden Sie im Abschnitt Kommunikationsbereichs- oder Kanaldatenstrukturen.

CICS-Kanäle enthalten eine Reihe von Strukturen, die als Container bezeichnet werden. In WebSphere Message Broker wird ein CICS-Kanal als Nachrichtensammlungsstruktur dargestellt. Eine Nachrichtensammlung kann untergeordnete Nachrichten enthalten, die vom CICSRequest-Knoten alle als einzelne Container behandelt werden. Weitere Informationen zum Erstellen einer Nachrichtensammlung mithilfe von ESQL finden Sie im Abschnitt Nachrichtensammlung mit ESQL erstellen.

Wenn nur ein einzelner Container für die Eingabe erforderlich ist, muss keine Nachrichtensammlung erstellt werden. Stattdessen kann eine normale Nachricht verwendet werden, wobei jedoch ein Kanalname und ein Containername, jeweils mit maximal 16 alphanumerischen Zeichen, in der lokalen Umgebung ('LocalEnvironment') festgelegt werden muss. Weitere Informationen zur Verwendung eines einzelnen Nachrichtenmodus finden Sie im Abschnitt Kommunikationsbereichs- oder Kanaldatenstrukturen.

Da im Voraus nicht bekannt ist, wie viele Container die Antwort enthält, wird als Ausgabe immer eine Nachrichtensammlung erstellt. Über die Eigenschaft Position für Ergebnisdaten des CICSRequestKnotens kann als Ausgabe die Ergebnisbaumstruktur auf einen einzigen Nachrichtenordner oder auch auf nur ein Feld oder eine untergeordnete Baumstruktur eingeschränkt werden.

Sie können einer Nachrichtensammlung Name/Wert-Attribute hinzufügen, um CICS-Container zu erstellen. Mit Ausnahme des Attributs CollectionName (Name der Sammlung) können Name/Wert-Attribute in der Nachrichtensammlung anstelle von kompletten Nachrichtenordnern für einfache Daten verwendet werden. Beispielsweise kann in der Nachrichtensammlung ein Name/Wert-Zeichenfolgeattribut festgelegt und direkt durch den CICSRequest-Knoten genutzt werden, ohne dass eine Nachrichtengruppe für das Element erstellt werden muss. Weitere Informationen zur Verwendung von Attributen finden Sie im Abschnitt Kommunikationsbereichs- oder Kanaldatenstrukturen.

Name/Wert-Attribute können von Containern sowohl bei der Ausgabe erstellt als auch bei der Eingabe akzeptiert werden. Wenn Sie ein Attributs anstelle eines Nachrichtenordners aus einem Container erstellen möchten, aktivieren Sie auf der Registerkarte 'Syntaxanalyse der Antwortnachricht' das entsprechende Kontrollkästchen.

Der CICSRequest-Knoten befindet sich im Ablagefach CICS der Nachrichtenflussknotenpalette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Diese Abbildung zeigt das Symbol für den CICSRequest-Knoten.

Das folgende Beispiel zeigt die Verwendung des CICSRequest-Knotens:
Mit dem folgenden Beispiel wird veranschaulicht, wie ein kanalbasiertes CICS-Programm aufgerufen wird, indem eine Nachrichtensammlung für den CICSRequest-Knoten erstellt und mit Daten gefüllt wird, und wie die Nachrichtensammlung nach diesem Aufruf verarbeitet wird.

Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im WebSphere Message Broker Toolkit integrierte Information Center verwendet wird.

Der CICSRequest-Knoten kann eine Identität aus einer Eingabenachricht an CICS weitergeben. Dazu wird die Eigenschaft Propagate (Weitergeben) des für den Knoten definierten Sicherheitsprofils verwendet. Sie finden weitere Informationen hierzu in den Abschnitten Sicherheitsberechtigungsnachweise an CICS Transaction Server for z/OS weitergeben und Weitergabe der Identitäts- und Sicherheitstoken.

Sie können im CICSRequest-Knoten einen Spiegeltransaktionsnamen angeben, unter dem CICS-Tasks und -Programme ausgeführt werden sollen. Eine solche Gruppierung erleichtert die Statistikerfassung sowie die Bestimmung der Taskpriorität erheblich. Weitere Informationen zu Spiegeltransaktionen finden Sie im Abschnitt CICS Transaction Server for z/OS-Spiegeltransaktionen.

Konfigurierbare Services für den CICSRequest-Knoten verwenden:

Sie können den CICSRequest-Knoten so konfigurieren, dass er Verbindungsdetails von einem konfigurierbaren Service abruft. Details zum Erstellen, Ändern, Dokumentieren und Löschen der konfigurierbaren Services finden Sie im Abschnitt Verbindungsinformationen für den CICSRequest-Knoten ändern.

Den CICSRequest-Knoten konfigurieren

Nachdem Sie eine Instanz des CICSRequest-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.

CICSRequest-Knoten für koordinierte Transaktionen konfigurieren:

Der unter Transaktionsmodus eingestellte Wert legt fest, ob die Anforderungen an den CICSRequest-Knoten als transaktionsorientiert behandelt werden.

Wenn der CICSRequest-Knoten bei einer abnormalen Beendigung so konfiguriert ist, dass er an der Brokertransaktion teilnimmt, wird die CICS-Task sofort mittels Rollback rückgängig gemacht. Sind mehrere CICS-Knoten an der Arbeitseinheit beteiligt, wird die CICS-Aktivität für alle diese Knoten rückgängig gemacht, unabhängig davon, ob die abnormale Beendigung durch ein "Error"- oder "Failure"-Terminal verarbeitet wird. Jegliche weitere Arbeit, die von CICS in Verbindung mit der Verarbeitung dieser Nachricht ausgeführt wird, wird in einer neuen Arbeitseinheit durchgeführt.

Überschreibungen der lokalen Umgebung

In der lokalen Umgebung können Sie folgende Werte für einzelne Nachrichten dynamisch überschreiben: das aufzurufende CICS-Programm, die Länge des Kommunikationsbereichs, die Spiegeltransaktionen und die Verarbeitung der Antwortnachricht. Der Abschnitt Überschreibungen für den CICSRequest-Knoten in der lokalen Umgebung enthält weitere Informationen hierzu.

Terminals und Eigenschaften

In der folgenden Tabelle werden die CICSRequest-Knotenterminals beschrieben .
Terminal Beschreibung
Eingangsterminal (In) Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt. Der CICSRequest-Knoten wird über eine Nachricht gesteuert, die beim Eingabeterminal eingeht. Daten werden aus der Nachrichtenbaumstruktur an CICS gesendet.
Ausgang Das Ausgabeterminal, von dem die Nachrichtenbaumstruktur, einschließlich der von CICS zurückgegebenen Daten, weitergegeben wird.
Fehlerterminal (Failure) Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn eine Ausnahmebedingung des CICSRequest-Knotens erkannt wird oder ein Fehler in der Verbindung zwischen dem CICSRequest-Knoten und CICS auftritt.
Fehler Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn ein CICS-Fehler (abnormale Beendigung) auftritt. Die Eingabenachricht wird mit dem Feld CICS\AbendCode in 'LocalEnvironment' weitergegeben. Wenn keine Verbindung zu diesem Fehlerterminal besteht und ein Abbruch von CICS auftritt, wird dieser Abbruch nicht festgestellt.
Timeout Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn ein Zeitlimit pro Anforderung wirksam wird, während eine einzelne Anforderung an CICS gesendet wird, aber die Anforderung zu viel Zeit benötigt. Die Ausgabenachricht enthält den Hauptteil der Eingabenachricht und eine Zeitlimitausnahmebedingung in der Ausnahmeliste. Falls kein Zeitlimitterminal angeschlossen ist und eine Zeitlimitüberschreitung eintritt, wird die Anforderungszeitlimit-Ausnahmebedingung an das Fehlerterminal (Failure) weitergeleitet. Wenn keine Verbindung zu diesem Fehlerterminal (Failure) besteht, löst der Broker eine Ausnahmebedingung aus und gibt die Steuerung an den nächsten vorgeordneten Knoten zurück, der die Ausnahmebedingung verarbeiten kann. Das Standardverhalten besteht darin, dass die Nachricht an den Empfangsknoten zurückgegeben wird.

In den folgenden Tabellen werden die Eigenschaften des CICSRequest-Knotens beschrieben.

In Tabellenspalte O ist angegeben, ob die Eigenschaft obligatorisch ist. Wenn eine Eigenschaft mit einem Stern markiert ist, bedeutet dies, dass Sie einen Wert eingeben müssen, falls kein Standardwert festgelegt ist.

In der Spalte K ist angegeben, ob die Eigenschaft konfigurierbar ist. Beispielsweise können Sie den Wert ändern, wenn Sie den Nachrichtenfluss zur BAR-Datei hinzufügen, um ihn zu implementieren.

In der folgenden Tabelle werden die Beschreibungseigenschaften des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Knotenname Ja Nein CICSRequest Der Name des Knotens.
Kurzbeschreibung Nein Nein Ohne Kurze Beschreibung des Knotens.
Langbeschreibung Nein Nein Ohne Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt
In der folgenden Tabelle werden die grundlegenden Eigenschaften des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
CICS-Server Ja Ja Ohne Die Eigenschaft CICS-Server gibt entweder den Namen eines konfigurierbaren Service, z. B. myCICSConnection, oder eine URL an. In einer URL können ein Protokoll, ein Hostname und eine Portnummer angegeben werden. Dies sind die mindestens erforderlichen Angaben für eine Verbindung zur CICS-Zielregion.

Die URL muss wie folgt aufgebaut sein:

Protokoll://Hostname:Port

Dabei gilt:

  • Protokoll kann den Wert tcp oder ssl haben.
  • Hostname ist die TCP/IP-Adresse von Internet Protocol Version 4 (IPv4) oder der mittels DNS auflösbare Hostname des CICS-Hosts.
  • Port bezeichnet die Portnummer des TCPIPSERVICE-Empfangsprogramms in CICS, das für IPIC-Anforderungen über TCP/IP bzw. Secure Sockets Layer (SSL) empfangsbereit ist. Sie können eine gültige Ganzzahl im Bereich von 1 bis 65535 eingeben.

Beispiel: tcp://mycicsregion.com:12345 oder ssl://mycicsregion.com:56789.

Die Werte für Hostname und Port können über die IPIC-TCPIPSERVICE-Definition in der Zielregion von CICS bezogen werden.

cicsServer
Programmname Ja Nein Ohne Die Eigenschaft 'Programmname' bezeichnet den Namen der Anwendung in der CICS-Zielregion, die Sie aufrufen.

Es werden sowohl Programme, die mit Kommunikationsbereichen arbeiten, als auch solche, die Kanäle verwenden, unterstützt.

Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/CICSProgramName
 
Datenstruktur Ja Nein Kommunikationsbereich Gibt an, ob eine Kommunikationsbereichs- oder eine Kanaldatenstruktur verwendet werden soll. Der Standardwert für diese Eigenschaft ist Commarea (Kommunikationsbereich). Die Entscheidung hängt vom jeweiligen CICS-Zielprogramm ab, also z. B. davon, ob es sich um ein kanalbasiertes Zielprogramm handelt oder nicht.  
Länge des Kommunikationsbereichs Ja Nein 0

Die Eigenschaft Kommunikationsbereichslänge bezeichnet die Größe des Kommunikationsbereichs in Byte, der vom CICS-Programm verwendet wird. Diese Bytegröße wird an CICS gesendet und bevor das Programm gestartet wird, wird ein Speicherbereich mit derselben Größe eingerichtet. Wenn Sie beispielsweise einen Wert von 100 für die Länge des Kommunikationsbereichs senden, wird ein Speicherbereich mit 100 Bytes angelegt. Das Programm greift auf diesen Bereich als den DFHCOMMAREA zu.

Stellen Sie sicher, dass der Eigenschaftswert Länge des Kommunikationsbereichs groß genug ist, um die Daten der Eingabeanforderung oder der Ausgabeantwort zu enthalten, ohne den Maximalwert von 32767 Bytes zu überschreiten. Wenn der Wert für Länge des Kommunikationsbereichs nicht groß genug für die Antwortdaten oder die Anforderungsdaten ist, kommt es in zu einem Speicherverlust in CICS.

Die Größe des Kommunikationsbereichs kann nicht vom CICS-Programm geändert werden.

Überschreiten die serialisierten Anforderungsdaten die Kommunikationsbereichslänge, werden die Daten auf die Länge des Kommunikationsbereichs abgeschnitten.

Sie können den Wert für die Kommunikationsbereichslänge beim CICS-Administrator oder -Entwickler erfragen.

Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/CICSCommareaLen

Diese Eigenschaft ist nicht konfigurierbar, wenn für die Eigenschaft Datenstruktur der Wert Kanal angegeben ist.

 
Sicherheitsidentität Nein Ja Ohne Der Name des Sicherheitsidentitätsobjekts, das durch den Befehl mqsisetdbparms erstellt und konfiguriert wird, der die Benutzer-ID und das Kennwort enthält, die vom Broker zur Authentifizierung der Verbindung mit CICS verwendet werden. Mit dem Befehl mqsisetdbparms legen Sie die Benutzer-ID und das Kennwort für die Sicherheitsidentität fest, auf die der Broker zugreift.

Der Standardwert für diese Eigenschaft ist 'Keine', das bedeutet, dass Benutzer-ID und Kennwort nicht an CICS übergeben werden.

Weitere Informationen zur Unterstützung für die CICS-Sicherheitsidentität finden Sie unter mqsisetdbparms-Befehl.

securityIdentity
Anforderungszeitlimit (in Sekunden) Ja Ja 120 Falls einzelne an CICS gesendete Anforderungen mehr Zeit beanspruchen als hier angegeben, wird der Anforderungsversuch abgebrochen.

Ein Anforderungszeitlimit verursacht eine Ausnahmebedingung, die vom Zeitlimitterminal weitergegeben werden muss. Falls kein Zeitlimitterminal angeschlossen ist, wird die Anforderungszeitlimit-Ausnahmebedingung an das Fehlerterminal (Failure) weitergeleitet. Wenn keine Verbindung zu diesem Fehlerterminal (Failure) besteht, löst der Broker eine Ausnahmebedingung aus und gibt die Steuerung an den nächsten vorgeordneten Knoten zurück, der die Ausnahmebedingung verarbeiten kann. Das Standardverhalten besteht darin, dass die Nachricht an den Empfangsknoten zurückgegeben wird.

Bei einem Wert von 0 gibt es kein Zeitlimit.

requestTimeoutSecs
Spiegeltransaktions-ID Nein Ja Ohne

Sie können einen Spiegeltransaktionsnamen angeben, indem Sie diese Eigenschaft konfigurieren. Der von Ihnen angegebene Wert der Eigenschaft Spiegeltransaktions-ID muss jedoch mit dem Namen einer in CICS definierten Ressource vom Typ 'TRANSACTION' übereinstimmen.

Wenn Sie in CICS beispielsweise eine Transaktionsressource mit dem Namen ATRN definiert haben und Tasks und Programme unter dieser Transaktion ausgeführt werden sollen, müssen Sie ATRN als Wert der Eigenschaft Spiegeltransaktions-ID angeben.

Bei Implementierung des Nachrichtenflusses, der den konfigurierten CICSRequest-Knoten enthält, wird für alle CICS-Programme, die anschließend gestartet werden, in CICS angezeigt, dass sie unter der Spiegeltransaktion ausgeführt werden.

Wenn für die Eigenschaft Spiegeltransaktions-ID kein Wert festgelegt ist, wird beim Aufruf von einer verteilten Plattform der Standardwert CPMI und bei Aufruf durch ein z/OS-System der Standardwert CSMI als Spiegeltransaktionsname verwendet.

Weitere Informationen zu Spiegeltransaktionen finden Sie im Abschnitt CICS Transaction Server for z/OS-Spiegeltransaktionen.

mirrorTran
Nur EIBTRNID definieren Nein Ja Nicht ausgewählt

Sie können eine schwächere Form der Spiegeltransaktion verwenden, mit der nicht die Ressource vom Typ 'TRANSACTION' geändert, sondern lediglich ein Wert für die Variable EIBTRNID festgelegt wird, die für das aufrufende Programm verfügbar ist. Sie können die Variable EIBTRNID so konfigurieren, dass sie dem Programm die Information übermittelt, unter welcher Transaktionsressource es ausgeführt wird, ohne dass die Transaktionsressource in CICS definiert sein muss.

Beispielsweise können Sie diese schwächere Form der Spiegeltransaktion konfigurieren, indem Sie als Wert der Eigenschaft Spiegeltransaktions-ID den Namen der erforderlichen Transaktionsressource angeben, z. B. ATRN, und dann diese Eigenschaft auswählen.

Bei Implementierung des Nachrichtenflusses, der den konfigurierten CICSRequest-Knoten enthält, wird für alle CICS-Programme, die anschließend gestartet werden, in CICS angezeigt, dass sie unter der Spiegeltransaktion ausgeführt werden.

Wenn für die Eigenschaft Spiegeltransaktions-ID kein Wert festgelegt ist, wird beim Aufruf von einer verteilten Plattform der Standardwert CPMI und bei Aufruf durch ein z/OS-System der Standardwert CSMI als Spiegeltransaktionsname verwendet.

Weitere Informationen zu Spiegeltransaktionen finden Sie im Abschnitt CICS Transaction Server for z/OS-Spiegeltransaktionen.

eibtrnidOnly
In der folgenden Tabelle werden die Eigenschaften für die Transaktionalität des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Nein Nein Automatisch Gibt an, wie Aktualisierungen verwaltet werden.
  • Beginn der ÄnderungWenn Sie Ja auswählen, nimmt der CICSRequest-Knoten an der lokalen Transaktion teil, die durch den Empfangsknoten des Nachrichtenflusses gestartet wurde. Wenn der CICSRequest-Knoten bei einer abnormalen Beendigung so konfiguriert ist, dass er an der Brokertransaktion teilnimmt, wird die CICS-Task sofort mittels Rollback rückgängig gemacht. Sind mehrere CICS-Knoten an der Arbeitseinheit beteiligt, wird die CICS-Aktivität für alle diese Knoten rückgängig gemacht, unabhängig davon, ob die abnormale Beendigung durch ein "Error"- oder "Failure"-Terminal verarbeitet wird. Jegliche weitere Arbeit, die von CICS in Verbindung mit der Verarbeitung dieser Nachricht ausgeführt wird, wird in einer neuen Arbeitseinheit durchgeführt. Der Abschnitt Antworten von einem CICSRequest-Knoten verarbeiten enthält weitere Informationen hierzu.Ende der Änderung
  • Wenn Sie Nein auswählen, nimmt der CICSRequest-Knoten nicht an der lokalen Transaktion teil, die durch den Empfangsknoten des Nachrichtenflusses gestartet wurde.
  • Bei Auswahl von Automatisch wird die Transaktionalität der Nachricht am Anfang des Nachrichtenflusses aus der Einstellung der Eigenschaft Transaktionsmodus des Empfangsknoten übernommen. Wird der Nachrichtenfluss beispielsweise durch einen MQInput-Knoten gesteuert, übernimmt der CICSRequest-Knoten den für den MQInput-Knoten eingestellten Transaktionsmodus.

Weitere Informationen zur Transaktionalität finden Sie im Abschnitt Nachrichtenflusstransaktionen.

In der folgenden Tabelle werden die Anforderungseigenschaften des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Datenposition Ja Nein $Body Die Position innerhalb der Baumstruktur der eingehenden Nachricht, aus der Daten für die Anforderung abgerufen werden, die vom CICSRequest-Knoten an CICS gesendet werden. Der Standardwert $Body steht für den Text der eingehenden Nachricht. Sie können jeden XPath- oder ESQL-Ausdruck eingeben, der die Position der Nachrichtenbaumstruktur angibt, die serialisiert und an CICS gesendet werden soll.
Position der Überschreibung des Programmnamens Nein Nein $LocalEnvironment/Destination/CICS/CICSProgramName Das Element der Nachrichten-Assembly, das den Namen des in CICS auszuführenden Programms enthält.
In der folgenden Tabelle werden die Ergebniseigenschaften des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Position für Ergebnisdaten Nein Nein $ResultRoot Diese Eigenschaft gibt an, welche untergeordnete Baumstruktur des Ergebnisses in der Nachricht platziert werden soll. Wenn für diese Eigenschaft kein Wert angegeben ist, wird $ResultRoot als Standardwert verwendet, und die gesamte Antwort wird in der Ausgabenachricht an der Stelle platziert, die in der Eigenschaft Position für Ausgabedaten angegeben ist.

Weitere Informationen hierzu finden Sie unter Ergebnisnachricht mit einer eingehenden Nachricht kombinieren.

Position für Ausgabedaten Nein Nein $OutputRoot Die Position in der Nachrichtenbaumstruktur, an die der CICSRequest-Knoten Ausgabedaten sendet. Der Standardwert $OutputRoot bedeutet, dass die eingehende Nachricht durch die Antwort ersetzt wird.

Weitere Informationen hierzu finden Sie unter Ergebnisnachricht mit einer eingehenden Nachricht kombinieren.

Lokale Umgebung kopieren Nein Nein Ausgewählt Diese Eigenschaft gibt an, ob die eingehende lokale Umgebung kopiert oder weitergeleitet wird. Dieses Kontrollkästchen ist standardmäßig aktiviert, d. h., die lokale Umgebung wird kopiert, sodass die eingehende lokale Umgebung erhalten bleibt. Die Hinzufügungen zur lokalen Umgebung sind nur für Knoten, die diesem Knoten nachgeordnet sind, sichtbar. Wenn dieses Kontrollkästchen inaktiviert ist, wird die eingehende lokale Umgebung für die abgehende Nachricht verwendet. Alle von diesem Knoten an der lokalen Umgebung vorgenommenen Änderungen sind sowohl für nachgeordnete als auch vorgeordnete Knoten sichtbar, nachdem dieser Knoten die Verarbeitung beendet hat.
In der folgenden Tabelle werden die Standardeigenschaften von 'Syntaxanalyse der Antwortnachricht' des CICSRequest-Knotens beschrieben.
Eigenschaft O K Standardwert Beschreibung
Nachrichtendomäne Nein Nein Ohne
Bei Verwendung einer Kommunikationsbereichsdatenstruktur:
Die Domäne, die für die Syntaxanalyse des Bitstroms für den Antwortkommunikationsbereich verwendet werden soll.
Bei Verwendung einer Kanaldatenstruktur:
Die Domäne, die für die Syntaxanalyse des Bitstroms für den Antwortcontainer verwendet werden soll.
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageDomain
Nachrichtengruppe Nein Nein Ohne
Bei Verwendung einer Kommunikationsbereichs- oder Kanaldatenstruktur:
Der Name der Nachrichtengruppe, in der die Antwortnachricht definiert ist.

Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten anschließend aktualisieren, um diesen Nachrichtengruppenverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her.

Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageSet
Nachrichtentyp Nein Nein Ohne
Bei Verwendung einer Kommunikationsbereichs- oder Kanaldatenstruktur:
Der Typ der Antwortnachricht.
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageType
Nachrichtenformat Nein Nein Ohne
Bei Verwendung einer Kommunikationsbereichs- oder Kanaldatenstruktur:
Der Name des physischen Formats der Antwortnachricht.
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageFormat
ID des codierten Nachrichtenzeichensatzes Nein Nein EBCDIC (037)
Bei Verwendung einer Kommunikationsbereichsdatenstruktur:
Die ID des codierten Zeichensatzes (CCSID), mit dem die Bytes des Antwortkommunikationsbereichs interpretiert werden. Mit dieser Eigenschaft wird die CCSID für die von CICS zurückgegebene Nachricht definiert.
Bei Verwendung einer Kanaldatenstruktur:
Die ID des codierten Zeichensatzes (CCSID), mit dem die Bytes des Antwortcontainers interpretiert werden.
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageCCSID

Eine Liste mit gültigen Werten finden Sie im Abschnitt Unterstützte Codepages.

Nachrichtenverschlüsselung Nein Nein Big Endian, mit S390-Gleitkomma (785)
Bei Verwendung einer Kommunikationsbereichsdatenstruktur:
Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die Bytes des Antwortkommunikationsbereichs interpretiert werden. Mit dieser Eigenschaft wird die Nachrichtencodierung für die von CICS zurückgegebene Nachricht definiert.
Bei Verwendung einer Kanaldatenstruktur:
Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die Bytes des Antwortcontainers interpretiert werden, das für Zeichencontainer jedoch ignoriert wird.
Gültige Werte sind:
  • Little Endian, mit IEEE-Gleitkomma (546)
  • Big Endian, mit IEEE-Gleitkomma (273)
  • Big Endian, mit S390-Gleitkomma (785) (der Standardwert)
  • Ermitteltes Brokersystem
Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung.
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
$LocalEnvironment/Destination/CICS/Response/messageEncoding
Kanaloptionen
Wenn auf der Registerkarte 'Grundeinstellung' für die Eigenschaft Datenstruktur der Wert Kanal angegeben ist, wird auf der Registerkarte 'Syntaxanalyse der Antwortnachricht' die Tabelle 'Kanaloptionen' zusätzlich verfügbar. In der Tabelle 'Kanaloptionen' können Sie die Standard-Nachrichtenschablonen-Eigenschaften überschreiben, indem Sie - für jeden Ordner einzeln - Syntaxanalyseoptionen für einzelne Antwortcontainer für die Ausgabe aus dem CICSRequest-Knoten angeben. Sie können stattdessen auch in der Nachrichtensammlung, die den Container enthalten soll, ein Name/Wert-Attribut erstellen, in dem Sie das entsprechende Kontrollkästchen aktivieren.

Wenn in der Tabelle 'Kanaloptionen' Containerdetails angegeben sind, werden diese vorrangig vor den Standard-Nachrichtenschablonen-Eigenschaften verwendet. Wenn in der Tabelle 'Kanaloptionen' keine Containerdetails angegeben sind und das Kontrollkästchen für das Attribut aktiviert ist, wird ein Name/Wert-Paar erstellt. Wenn in der Tabelle 'Kanaloptionen' keine Containerdetails angegeben sind und das Kontrollkästchen für das Attribut nicht aktiviert ist, werden die Standard-Nachrichtenschablonen-Eigenschaften verwendet.

In der folgenden Tabelle werden die Eigenschaften für die Parser-Optionen des CICSRequest-Knotens beschrieben.

Eigenschaft O K Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Ja Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Antwortnachricht syntaktisch analysiert wird. Gültige Werte sind Bei Bedarf, Sofort und Vollständig.

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser die Datentypen der in der Nachrichtenbaumstruktur erstellten Syntaxelemente aus dem XML-Schema entnimmt.Diese Eigenschaft kann nur ausgewählt werden, wenn für die Eigenschaft Auswerten auf der Registerkarte Auswertung Inhalt oder Inhalt und Wert festgelegt wurde.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Antwortnachrichtendaten unter XMLNSC in Knoten, die mit dem Ausgabeterminal verbunden sind, angezeigt, wenn XMLNS die Domäne des MQRFH2-Eingabeheaders oder der Eigenschaften von 'Syntaxanalyse der Antwortnachricht' ist.
Zugriff auf gemischten Inhalt Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von gemischtem Text in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert und es werden keine Elemente erstellt.
Kommentare beibehalten Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Kommentaren in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Ja Nein Nicht ausgewählt Durch diese Eigenschaft wird gesteuert, ob der XMLNSC-Parser beim Feststellen von Verarbeitungsanweisungen in einer Antwortnachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein Leer Diese Eigenschaft legt eine Liste der Elemente der Antwortnachricht fest, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist.

In der folgenden Tabelle werden die Validierungseigenschaften des CICSRequest-Knotens beschrieben.

Eine vollständige Beschreibung zu diesen Eigenschaften erhalten Sie unter Auswertungseigenschaften.
Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Ja Ja Ohne Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind Keine, Inhalt und Wert, Inhalt und Übernehmen. validateMaster
Fehlerbehebungsmaßnahme Ja Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Sie können diese Eigenschaft nur angeben, wenn Sie Auswerten auf Inhalt oder Inhalt und Wert gesetzt haben. Gültige Werte sind Benutzertrace, Lokales Fehlerprotokoll, Ausnahmebedingung und Ausnahmeliste.  
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standardwert Beschreibung
Ereignisse Nein Nein Ohne Auf dieser Registerkarte werden Ereignisse angezeigt, die Sie für den Knoten definiert haben. Standardmäßig sind für keinen Knoten in einem Nachrichtenfluss Überwachungsereignisse definiert. Über Hinzufügen, Bearbeiten und Löschen können Sie Überwachungsereignisse für den Knoten erstellen, ändern oder löschen (Details siehe Überwachungsereignisquellen mithilfe von Überwachungseigenschaften konfigurieren).

Sie können hier angezeigte Ereignisse aktivieren oder inaktivieren, indem Sie das Kontrollkästchen Aktiviert aktivieren oder inaktivieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:22


ReferenzthemaReferenzthema | Version 8.0.0.5 | bc16010_