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.

CDOutput-Knoten

Verwenden Sie den CDOutput-Knoten, wenn Sie IBM® Sterling Connect:Direct zusammen mit WebSphere Message Broker verwenden.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

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:

Symbol für CDOutput-Knoten

Verwendung dieses Knotens in einem Nachrichtenfluss

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.

Das folgende Beispiel zeigt, wie dieser Knoten verwendet 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.

Terminals und Eigenschaften

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.

Folgende Angaben können überschrieben werden:
  • Name des sekundären Connect:Direct-Servers (SNODE)
  • Prozessname
  • Abrechnungsdaten
  • Zieldateiverzeichnis
  • Zieldateiname
  • Optionen für Kopierquelle einschließlich SYSOPTS
  • Optionen für Kopierziel einschließlich SYSOPTS
Ändern Sie zu diesem Zweck die Angabe in der Nachrichtenbaumstruktur LocalEnvironment.Destination.CD (weiterer Informationen siehe Variablen der lokalen Umgebung mit Dateiknoten verwenden).

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:
  • RPL - Datei ersetzen oder eine neue Datei erstellen
  • MOD - An vorhandene Datei anhängen. Diese Option ist unter z/OS nicht verfügbar.
  • NEW - Neue Datei erstellen

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:
  • Datensatz 'Gesamte Datei'
  • Datensatz 'Nicht geänderte Daten'
  • Datensatz 'Daten mit fester Länge'
  • Datensatz 'Daten mit Begrenzer'
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:
  • Linienende des Brokersystems
  • Angepasster Begrenzer (hexadezimal)
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:
  • Postfix
  • Infix

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:
  • Ohne
  • Inhalt und Wert
  • Inhalt
  • Übernehmen
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:
  • Benutzertrace
  • Lokales Fehlerprotokoll
  • Ausnahme
  • 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:21


ReferenzthemaReferenzthema | Version 8.0.0.5 | bc14015_