Verwenden Sie einen
CDOutput-Knoten, um eine Datei aus einem angegebenen
Verzeichnis auf Ihrem primären Connect:Direct-Server (PNODE) an einen
Dateinamen und ein Verzeichnis auf einem sekundären Connect:Direct-Server
(SNODE) zu senden.
In diesem Abschnitt wird die Verwendung des
CDOutput-Knotens in einem Nachrichtenfluss beschrieben.
Dabei wird vorausgesetzt, dass der übrige Nachrichtenfluss zum Beispiel einen
MQInput- zu einem
CDOutput-Knoten entwickelt hat.
Es ist möglich,
mehrere CDOutput-Knoten in derselben Ausführungsgruppe
oder in verschiedenen Ausführungsgruppen im selben Broker zu implementieren. CDOutput-Knoten können eine einzige Datei pro
Übertragung senden. Jede Datei kann mehrere Sätze enthalten und jeder Satz kann mehrere Elemente
enthalten. Übertragungen aus dem CDOutput-Knoten sind
nicht blockierend.
Gehen Sie wie folgt vor:
- Legen Sie für den CDOutput-Knoten die erforderlichen Knoteneigenschaften fest.
Wenn Sie nur die Eigenschaft
Zieldateiname festlegen
und für alle anderen die Standardwerte übernehmen, wird die Datei übertragen:
- vom primären Connect:Direct-Server (PNODE) zurück an sich selbst,
- in das standardmäßige Übertragungsverzeichnis unter Verwendung des
Standardprozessnamens.
Außerdem wird die Datei erstellt, falls sie nicht vorhanden ist,
oder ersetzt, falls sie bereits vorhanden ist.
Die folgende Tabelle enthält eine Übersicht über die Eigenschaften des
CDOutput-Knotens, die Sie festlegen können. Außerdem
wird angegeben, auf welcher Registerkarte sie angezeigt werden und welchen Wert Sie auswählen
können:
Registerkarte |
Eigenschaft |
Wert |
Grundeinstellung |
Prozessname |
Sie können einen beliebigen Namen für den Prozess angeben.
Er darf jedoch nicht länger als acht Zeichen sein und keine Leerzeichen enthalten. |
SNODE |
Der sekundäre
Connect:Direct-Server, an den die Datei übertragen wird. |
Zieldateiverzeichnis |
Testverzeichnis auf dem
sekundären Connect:Direct-Server (SNODE). |
Zieldateiname |
Dateiname auf dem sekundären
Connect:Direct-Server (SNODE). |
Disposition |
RPL |
Übertragungsmodus |
Textmodus |
- Legen Sie mit dem Befehl mqsisetdbparms-Befehl den
Benutzernamen und das Kennwort fest, die für die Herstellung
der Verbindung vom CDOutput-Knoten zum primären
Connect:Direct-Server erforderlich sind.
- Implementieren Sie den Nachrichtenfluss auf dem Broker. Weitere Informationen hierzu finden Sie unter Verpacken und implementieren.
- Senden Sie die Datei an das Eingangsterminal des
CDOutput-Knotens.
Bei der Ausführung dieser Schritte geschieht Folgendes:
- Die Datei wird auf Basis der Werte erstellt, die in den Eigenschaften des
CDOutput-Knotens festgelegt sind.
- Die Datei wird im lokalen Dateisystem zwischengespeichert und dann ein Befehl an den
Connect:Direct-Server gesendet, der die Übertragung veranlasst.
- Wenn bereits eine Datei mit demselben Namen im ausgewählten Verzeichnis auf dem sekundären
Connect:Direct-Server vorhanden ist, bestimmt der Wert der Eigenschaft
Disposition, was mit der vorhandenen Datei geschieht; in diesem Beispiel wird
sie ersetzt.
Nach erfolgreicher Übertragung wird die lokale, zwischengespeicherte Datei
gelöscht.
Beim Senden einer Datei können folgende Eigenschaften dynamisch
festgelegt werden:
- Sekundärer Connect:Direct-Server (SNODE)
- Prozessname
- Abrechnungsdaten
- Zieldateiverzeichnis
- Zieldateiname
- Optionen für Kopierquelle
- Optionen für Kopierziel
Sie haben
volle Kontrolle über die Copy-Anweisungen.
Beispiel:
LocalEnvironment.Destination.CD.Copy.To.Option.PERMISS = '777'
bewirkt,
dass
IBM® Sterling Connect:Direct die Berechtigungen für die Zieldatei auf
777 bzw.
RWX RWX RWX) setzt, wenn sich die Zieldatei unter
einem
UNIX-Betriebssystem bzw. in Unix System Services unter
z/OS befindet.
Wenn Sie ein falsches Format eingeben,
wird jedoch bei der Übergabe des Prozessscripts ein Syntaxfehler erkannt, der dazu führt, dass im
Knoten eine Ausnahme ausgelöst wird.
Beispiel:
LocalEnvironment.Destination.CD.Copy.To.Option.PERMISS = '7xddd'
verursacht
einen Syntaxfehler, weil
'7xddd' nicht dem Format
nnn
entspricht. Wenn ein Fehler auftritt, ist das Prozessscript in der ausgelösten Ausnahme und im
Benutzertrace angegeben.
Tipp: Als Hilfestellung bei der Fehlerbestimmung können Sie das vom CDOutput-Knoten generierte Script anzeigen, indem Sie den Benutzertrace aktivieren.