Verwaltete Dateiübertragung mit IBM Sterling Connect:Direct einleiten

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.

Vorbereitungen

  1. Stellen Sie sicher, dass „ IBM® MQ “ auf demselben Rechner installiert ist wie „ IBM App Connect Enterprise “. Informationen zur Dateiübertragung werden in Speicherwarteschlangen gespeichert, die von „ IBM MQ “ verwaltet werden. Daher müssen Sie „ IBM MQ “ auf demselben Computer installieren wie „ IBM App Connect Enterprise “, wenn Sie die Funktionen des CDOutput -Knotens nutzen möchten.
  2. Stellen Sie sicher, dass ein Warteschlangenmanager als Eigner der Systemwarteschlangen angegeben wurde, in denen Informationen zur Dateiübertragung gespeichert werden.
  3. Erstellen Sie die Systemwarteschlangen, in denen die Dateiübertragungsinformationen gespeichert werden. Weitere Informationen zum Anlegen der Systemwarteschlangen finden Sie unter „Anlegen der Standard-Systemwarteschlangen auf einem Queue-Manager von IBM MQ “.
  4. Erstellen Sie einen Nachrichtenfluss mit einem CDOutput -Knoten. Erstellen Sie beispielsweise einen einfachen Nachrichtenfluss mit einem MQInput -Knoten, der mit einem CDOutput -Knoten verbunden ist.

Informationen zu dieser Task

Mehrere CDOutput -Knoten können auf demselben Integrationsserver implementiert werden. CDOutput -Knoten können eine 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.

Vorgehensweise

  1. Legen Sie die erforderlichen Knoteneigenschaften im Knoten CDOutput 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 zu 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.
    In der folgenden Tabelle sind die Eigenschaften des Knotens CDOutput zusammengefasst, die Sie festlegen können, auf welcher Registerkarte sie angezeigt werden, sowie ein Wert, den Sie auswählen können:
    Registerkarte Eigenschaft Wert
    Basis Prozessname Sie können einen beliebigen Namen für den Prozess angeben. Der Name darf jedoch nicht länger als acht Zeichen sein und keine Leerzeichen enthalten.
    SNODE Der sekundäre Connect:Direct -Server , auf den die Datei übertragen wird
    Zieldateiverzeichnis TestDir auf dem sekundären Connect:Direct -Server (SNODE).
    Zieldateiname Dateiname auf dem sekundären Connect:Direct -Server (SNODE).
    Disposition RPL
    Übertragungsmodus Textmodus
  2. Richten Sie Benutzername und Kennwort ein, die erforderlich sind, damit der CDAusgabe -Knoten über die mqsicredentials, Befehleine Verbindung zum primären Connect:Direct -Server herstellen kann. Alternativ können Sie den Befehl mqsisetdbparmsverwenden.
  3. Implementieren Sie den Nachrichtenfluss (siehe Integrationslösungen implementieren).
  4. Senden Sie die Datei an das Eingangsterminal des CDOutput -Knotens.

Ergebnisse

Bei der Ausführung dieser Schritte geschieht Folgendes:
  1. Die Datei wird gemäß den Werten erstellt, die in den Eigenschaften des CDOutput -Knotens festgelegt sind.
  2. Die Datei wird im lokalen Dateisystem zwischengespeichert und anschließend wird ein Befehl an den Connect:Direct -Server gesendet, um die Übertragung durchzuführen.
  3. Wenn eine Datei mit demselben Namen im ausgewählten Verzeichnis auf dem sekundären Connect:Direct -Servervorhanden ist, wird die Verarbeitung der vorhandenen Datei durch den Wert der Eigenschaft Disposition bestimmt. In diesem Beispiel wird die Datei 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.

Zum Beispiel:
LocalEnvironment.Destination.CD.Copy.To.Option.PERMISS = '777'
bewirkt, dass IBM Sterling™ Connect:Direct die Berechtigungen für die Zieldatei auf 777 (oder RWX RWX RWX) setzt, wenn sich die Zieldatei auf einem UNIX -Betriebssystem befindet, oder innerhalb der Unix -Systemdienste unter z/OS®.

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.

Zum 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: Zur Unterstützung bei der Fehlerbestimmung können Sie das vom CDOutput -Knoten generierte Script anzeigen, indem Sie den Benutzertrace aktivieren.