Verwenden Sie den CDOutput-Knoten, wenn Sie IBM® Sterling Connect:Direct zusammen mit WebSphere Message Broker verwenden.
Dieses Thema ist in folgende Abschnitte eingeteilt:
Verwenden Sie den CDOutput-Knoten, um die Nachrichtenbaumstruktur zu einer Datei zu serialisieren und anschließend zwischen zwei Connect:Direct-Servern zu übertragen. Bis die Datei zur Übertragung bereit ist, wird ein Verzeichnis im Arbeitspfad der Ausführungsgruppe als Bereitstellungsbereich verwendet. Nachdem die Datei übertragen wurde, wird sie aus dem Bereitstellungsbereich gelöscht.
Der CDOutput-Knoten befindet sich im Ablagefach Datei der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:
Sie können den CDOutput-Knoten in Verbindung mit einem anderen Transportempfangsknoten, z. B. MQInput, verwenden. Alle von WebSphere MQ empfangenen Daten werden an den CDOutput-Knoten gesendet, der die Datei in ein internes Verzeichnis schreibt, wobei der auf dem Knoten festgelegte Dateiname verwendet wird. Die Datei wird anschließend an den Ziel-Connect:Direct-Server übertragen, wo sie in das Verzeichnis und mit dem Dateinamen gespeichert wird, die auf dem Knoten festgelegt sind.
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.
In der folgenden Tabelle werden die Terminals des CDOutput-Knotens beschrieben:
Terminal | Beschreibung |
---|---|
Eingangsterminal (In) | Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt |
Dateibeendigungsterminal | Das Eingabeterminal, das eine Nachricht annimmt, welche die endgültige Verarbeitung einer Datei auslöst. |
Ausgang | Die am Eingangsterminal empfangene Nachricht wird an dieses Terminal weitergegeben, wenn der Datensatz erfolgreich geschrieben wurde. Die Nachricht bleibt bis auf Statusinformationen in der lokalen Umgebung unverändert. |
Datenendterminal | Die am Dateibeendigungsterminal empfangene Nachricht wird an dieses Terminal weitergegeben, wenn die Datei erfolgreich verarbeitet wurde. |
Fehlerterminal (Failure) | Das Ausgabeterminal, an das die Nachricht weitergeleitet wird, wenn beim Weitergeben einer Nachricht ein Fehler erkannt wird. |
In den folgenden Tabellen werden die Knoteneigenschaften beschrieben, die Sie in einer angegebenen Registerkarte festlegen können. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (im Toolkit mit einem Stern markiert, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte K zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss für die Implementierung zur BAR-Datei hinzugefügt wird).
Wenn der CDOutput-Knoten eine Nachricht an das Ausgabe- oder das Datenendeterminal weitergibt, werden die Informationen zu der Nachricht in der Nachrichtenbaumstruktur LocalEnvironment.WrittenDestination.CD gespeichert.
Eigenschaften Beschreibung
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Knotenname | Nein | Nein | CDOutput | Der Name des Knotens. |
Kurzbeschreibung | Nein | Nein | Ohne | Kurze Beschreibung des Knotens. |
Ausführliche Beschreibung | Nein | Nein | Ohne | Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt. |
Eigenschaften Grundeinstellungen
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
SNODE | Nein | Ja | Derselbe wie für PNODE | Der sekundäre Connect:Direct-Server (SNODE), an den
die Datei übertragen wird. Ist diese Eigenschaft nicht angegeben, wird die Datei zurück an den primären Connect:Direct-Server (PNODE) übertragen. Sie müssen auf dem PNODE eine Netmap konfigurieren, um sicherzustellen, dass die Übertragung den SNODE erreicht. Der Netmap-Eintrag für diesen SNODE muss im entsprechenden Feld den Betriebssystemtyp enthalten. Wenn sich der PNODE unter einem UNIX-Betriebssystem befindet, müssen Sie diese Information im Beschreibungsfeld der Netmap speichern. Die Beschreibung muss die Zeichenfolge 'remoteos=xxx' enthalten, wobei der Wert Windows, UNIX oder OS390 sein muss. Der CDOutput-Knoten kann nicht für Übertragungen an eine SNODE auf einem anderen Betriebssystem als diese drei verwendet werden. |
snode |
Zieldateiverzeichnis | Nein | Ja | Leere Zeichenfolge | Das Verzeichnis auf dem sekundären
Connect:Direct-Server (SNODE), in das die Datei übertragen wird. Das Verzeichnis muss bereits vorhanden sein. Bleibt dieses Feld leer, verwendet der SNODE das Standardverzeichnis. Wenn es sich unter z/OS bei dem Dateinamen um eine sequenzielle Datei oder ein Element einer partitionierten Datei handelt, lassen Sie das Verzeichnisfeld leer. |
destinationDirectory |
Zieldateiname | Ja | Ja | Ohne | Der genaue Dateiname oder ein Muster mit einem Platzhalterzeichen; definiert
den Namen der Datei, die vom sekundären Connect:Direct-Server (SNODE)
erstellt werden soll. Der Dateiname kann ein Muster sein, das ein einzelnes Platzhalterzeichen enthält. Der Platzhalterwert wird dem Element im Ordner LocalEnvironment.Wildcard.WildcardMatch der lokalen Umgebung entnommen. Dieser Wert wird normalerweise von CDInput- oder FileInput-Knoten festgelegt. Wenn beispielsweise der CDInput-Knoten sein Dateimuster auf *.in festlegt, gleicht er die Datei test.in als "test" ab. Wenn das Dateimuster des CDOutput-Knotens auf *.out gesetzt ist, wird "test" ersetzt, um den Dateinamen test.out zu erzeugen. Der Dateiname muss festgelegt werden, kann aber über das Feld LocalEnvironment.Destination.CD.Name in der lokalen Umgebung überschrieben werden. Sie können unter z/OS sequenzielle oder partitionierte Dateien angeben. Geben Sie für sequenzielle Dateien immer den vollständigen Namen der Datei an, z. B. MBUSER.TEST1. Geben Sie für ein Element in einer partitionierten Datei den Teildateinamen in Klammern an, z. B. MBUSER.TEST(MEME01). Es kann ein einziges Platzhalterzeichen an einer beliebigen Stelle im Dateinamen angegeben werden; es hat dieselbe Funktion wie bei normalen Dateinamensmustern. |
destinationFileName |
Konfigurierbarer CDServer-Service | Nein | Ja | Standardwert | Der Name des konfigurierbaren Service, der zur Herstellung der Verbindung mit
dem primären Connect:Direct-Server (PNODE) verwendet wird, um die
Übertragung einzuleiten. Ist dieser Wert nicht angegeben, wird der standardmäßige konfigurierbare Service (mit dem Namen "Default") verwendet. Der standardmäßige konfigurierbare Service stellt eine Verbindung mit einem PNODE her, der sich auf demselben System wie der Broker befindet, und verwendet Standardportkonfigurationen. Der standardmäßige konfigurierbare Service verwendet außerdem die Sicherheitsidentität "default", die mit dem Befehl mqsisetdbparms erstellt werden muss; Beispiel: mqsisetdbparms MB8BROKER -n cd::default -u mqbroker -p xxxxxxx Informationen zu verschiedenen Konfigurationen bei Verwendung von IBM Sterling Connect:Direct finden Sie im Abschnitt Erweiterte Konfigurationseigenschaften bei Verwendung von IBM Sterling Connect:Direct-Knoten und in den Ausgabeabschnitten. |
|
Prozessname | Nein | Ja | Ohne | Der Name für das Prozessscript, das generiert wird, um die Datei vom primären
Connect:Direct-Server (PNODE) an den sekundären
Connect:Direct-Server (SNODE) zu senden. Verwenden Sie diese Option, wenn Sie die Übertragung eindeutig identifizieren möchten. Ist dieser Wert nicht angegeben, wird der Prozessname WMBPROC verwendet. Sie können im Prozessscript einen beliebigen Namen angeben. Der Name darf jedoch nicht länger als acht Zeichen sein und keine Leerzeichen enthalten. |
processName |
Disposition | Ja | Ja | RPL - Datei ersetzen | Gibt an, wie die Datei auf dem sekundären System erstellt wird:
Unter z/OS werden für partitionierte Dateien nur die Optionen RPL und NEW unterstützt. Bei Angabe von NEW wird versucht, eine neue partitionierte Datei mit folgenden IBM Sterling Connect:Direct SPACE-Optionen anzulegen: '(23036,(2,1,1))' Sie können diese Werte in der lokalen Umgebung wie folgt überschreiben: LocalEnvironment.Destination.CD.Copy.To.Option.SPACE = |
disposition |
Übertragungsmodus | Ja | Ja | Binäre Übertragung (keine Konvertierung) | Der Modus für die Übertragung der Datei: binary - Datei wird binär übertragen, ohne Konvertierung text - Datei wird mit Konvertierung zwischen lokalen Codepages, wenn erforderlich, übertragen Bei Verwendung des Übertragungsmodus "text" unter z/OS verlangt IBM Sterling Connect:Direct, dass die Datei mindestens ein Zeilenvorschubzeichen enthält. Sie müssen sicherstellen, dass die Datei für IBM Sterling Connect:Direct im richtigen Format erstellt wird, damit die Textübertragung erfolgreich durchgeführt wird. |
transferMode |
Eigenschaften Anforderung
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Datenposition | Nein | Nein | $Body | Dies ist die Position in der Baumstruktur der Eingabenachricht, die den Datensatz enthält, der in die Ausgabedatei geschrieben werden soll. Der Standardwert $Body bezieht sich auf die gesamte Nachricht. |
Eigenschaften Datensätze und Elemente
Eigenschaft | O | K | Standardwert | Beschreibung |
---|---|---|---|---|
Dokumentdefinition | Ja | Nein | Datensatz 'Gesamte Datei' | Gibt an, wie Datensätze in die Ausgabedatei gestellt werden. Folgende Optionen sind gültig:
|
Länge (Bytes) | Ja | Nein | 80 | Die erforderliche Länge des Ausgabesatzes. Die Eigenschaft ist nur verfügbar, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. |
Auffüll-Byte (hexadezimal) | Ja | Nein | 20 | Das aus zwei Hexadezimalzeichen bestehende Byte, mit dem kurze Nachrichten aufgefüllt werden. Die Eigenschaft ist nur verfügbar, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. |
Begrenzer | Ja | Nein | Linienende des Brokersystems | Der zu verwendende Begrenzer. Die Eigenschaft ist nur verfügbar,
wenn unter Datensatzdefinition die Option
Datensatz 'Daten mit Begrenzer' angegeben ist. Folgende Optionen sind gültig:
|
Angepasster Begrenzer (hexadezimal) | Ja | Nein | Ohne | Die als Begrenzer zu verwendende Bytefolge. Die Eigenschaft ist nur verfügbar, wenn für die Eigenschaft Datensatzdefinition Datensatz 'Daten mit Begrenzer' und für die Eigenschaft Begrenzer Angepasster Begrenzer (hexadezimal) angegeben ist. |
Begrenzertyp | Ja | Nein | Postfix | Diese Eigenschaft gibt an, wie Begrenzer zwischen Datensätze
eingefügt werden. Die Eigenschaft ist nur verfügbar, wenn unter
Datensatzdefinition die Option
Datensatz 'Daten mit Begrenzer' angegeben ist.
Folgende Optionen sind gültig:
|
Eigenschaften Auswertung
Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.
Eigenschaft | O | K | Standardwert | Beschreibung | Eigenschaft des Befehls mqsiapplybaroverride |
---|---|---|---|---|---|
Auswertung | Ja | Ja | Übernehmen | Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
|
validateMaster |
Fehlerbehebungsmaßnahme | Ja | Nein | Ausnahme | Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung
geschieht. Die Eigenschaft ist nur verfügbar, wenn Sie
Auswerten auf
Inhalt oder Inhalt
und Wert gesetzt haben. Gültige Werte sind:
|
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. |