Verwenden Sie den CICSRequest-Knoten zum Aufrufen externer CICS Transaction Server for z/OS-Programme über das TCP/IP-basierte Protokoll IP InterCommunications (IPIC).
Ü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.
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:
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:
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.
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.
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.
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.
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 |
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:
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:
|
|
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:
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 |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Transaktionsmodus | Nein | Nein | Automatisch | Gibt an, wie Aktualisierungen verwaltet werden.
Weitere Informationen zur Transaktionalität finden Sie im Abschnitt Nachrichtenflusstransaktionen. |
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. |
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. |
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Nachrichtendomäne | Nein | Nein | Ohne |
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
|
Nachrichtengruppe | Nein | Nein | Ohne |
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:
|
Nachrichtentyp | Nein | Nein | Ohne |
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
|
Nachrichtenformat | Nein | Nein | Ohne |
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
|
ID des codierten Nachrichtenzeichensatzes | Nein | Nein | EBCDIC (037) |
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
Eine Liste mit gültigen Werten finden Sie im Abschnitt Unterstützte Codepages. |
Nachrichtenverschlüsselung | Nein | Nein | Big Endian, mit S390-Gleitkomma (785) |
Gültige Werte sind:
Diese Eigenschaft können Sie in der lokalen Umgebung durch einen Wert an folgender Position überschreiben:
|
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.
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. |
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. |