FileOutput-Knoten

Mit dem FileOutput-Knoten können Sie Nachrichten in Dateien schreiben.

Zweck

Nachrichten aus Nachrichtenflusstransaktionen können in eine Datei im Dateisystem des Brokers geschrieben werden. Jede Nachricht wird beim Schreiben in eine Datei in eine Bytefolge konvertiert, die als Datensatz bezeichnet wird. Die Datensätze werden akkumuliert, bis ein Prozess zur Verarbeitungsbeendigung ausgelöst wird. Die Verarbeitungsbeendigung erfolgt, wenn keine weiteren Datensätze mehr zur Verarbeitung vorhanden sind. Die akkumulierte Datei wird dann in das angegebene Ausgabeverzeichnis oder in ein Verzeichnis auf einem fernen FTP-Server gestellt. Wie die Datensätze in Dateien akkumuliert werden und wohin diese Dateien nach ihrer Beendigung gestellt werden, wird durch Knoteneigenschaften festgelegt.

Der FileOutput-Knoten befindet sich im Ablagefach Datei der Palette und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für Dateiausgabeknoten

Datensatzverarbeitung

Dateien werden vom FileOutput-Knoten als Folge von einem oder mehreren Datensätzen geschrieben. Die einzelnen Datensätze werden jeweils aus einer am Eingangsterminal des Knotens empfangenen Nachricht generiert.

Standardmäßig umfasst jede Datei nur einen einzigen Datensatz, und die Verarbeitungsbeendigung erfolgt unmittelbar, nachdem dieser Datensatz geschrieben wurde. In anderen Fällen ist durch Eigenschaften des FileOutput-Knotens festgelegt, dass die Datei mehrere Datensätze umfasst. Die Knoteneigenschaften geben dann auch an, wie die Datensätze in einer Datei akkumuliert werden. Datensätze können auf folgende Arten in einer Datei akkumuliert werden:
  • Einfach verknüpft. Die Datensätze der einzelnen Nachrichten werden unverändert der Datei hinzugefügt.
  • Aufgefüllt. Die einzelnen Datensätze werden auf eine bestimmte Länge ausgerichtet und gegebenenfalls mit einem Auffüllbyte aufgefüllt, bevor sie der Datei hinzugefügt werden.
  • Mit Begrenzer. Beim Hinzufügen in die Datei werden die Datensätze mit einem Begrenzer getrennt bzw. beendet.

Für jede am Eingangs- oder Dateibeendigungsterminal empfangene Nachricht können das Ausgabeverzeichnis und der Name der zu schreibenden (bzw. zu beendenden) Datei unter Verwendung von Nachrichtenelementen geändert werden. Diese Elemente, die sich standardmäßig auf Elemente in der lokalen Umgebung beziehen, können auf der Eigenschaftenregisterkarte Anforderung des Knotens angegeben werden.

Dateiverarbeitung (beenden)

Der FileOutput-Knoten schreibt akkumulierte Nachrichten in Dateien in einem angegebenen Verzeichnis, dem Ausgabeverzeichnis. Dies geschieht in folgenden Fällen:
  • Nach jedem Datensatz, wenn die Datei nur einen einzigen Datensatz enthalten soll. Hierfür muss für die Eigenschaft Datensatzdefinition auf der Registerkarte Datensätze und Elemente der Wert Datensatz 'Gesamte Datei' angegeben werden.
  • Wenn das Dateibeendigungsterminal eine Nachricht empfängt.
Der Name des Verzeichnisses und der Name der Datei werden durch die von Ihnen festgelegten Knoteneigenschaften sowie durch Elemente der gerade verarbeiteten Nachricht bestimmt.

Zum Erstellen von Dateien während der Verarbeitung sowie zum Verschieben von Dateien nach der Verarbeitung verwendet der FileOutput-Knoten Unterverzeichnisse des Ausgabeverzeichnisses. Alle diese Verzeichnisse beginnen mit dem Präfix mqsi. Zu diesen Verzeichnissen zählen unter anderem das Durchgangsverzeichnis mqsitransit sowie das Archivverzeichnis mqsiarchive. Die Datensätze werden nicht direkt in eine Datei im Ausgabeverzeichnis akkumuliert, sondern zunächst in eine Datei im Durchgangsverzeichnis. Erst nach Beendigung der Verarbeitung werden die Dateien aus dem Durchgangsverzeichnis in das Ausgabeverzeichnis verschoben. Wenn der Name einer Datei, die in das Ausgabeverzeichnis verschoben werden soll, mit dem Namen einer bereits im Ausgabeverzeichnis enthaltenen Datei identisch ist, kann die Datei im Ausgabeverzeichnis gelöscht, in das Archivverzeichnis 'mqsiarchive' verschoben oder zunächst umbenannt und dann in das Verzeichnis 'mqsiarchive' verschoben werden.

Sie können angeben, dass der FileOutput-Knoten im Rahmen der Verarbeitungsbeendigung Dateien auf einen fernen FTP-Server übertragen soll. Nach ihrer erfolgreichen Übertragung kann eine Datei aus dem lokalen Dateisystem gelöscht werden. Sie kann dort aber auch verbleiben, um während der weiteren Verarbeitung normal angezeigt zu werden.

Werden mehrere Datensätze geschrieben, kommt es nicht nach jedem Datensatz zu einer Verarbeitungsbeendigung. Diese findet erst statt, wenn an dem Dateibeendigungsterminal des Knotens eine Nachricht empfangen wird. Jede am Dateibeendigungsterminal eingehende Nachricht bewirkt, dass der Beendigungsprozess initiiert wird. Während dieses Prozesses wird die Datei aus dem Durchgangsverzeichnis entweder in das angegebene Ausgangsverzeichnis oder in ein Verzeichnis auf einem fernen FTP-Server verschoben.

Nicht als Fehler gilt, wenn das Durchgangsverzeichnis bei der Initiierung des Beendigungsprozesses leer ist.

Wenn Sie für die Eigenschaft Datensatzdefinition auf der Registerkarte Datensätze und Elemente den Wert Datensatz 'Gesamte Datei' angeben, erfolgt keine Verarbeitungsbeendigung, wenn am Dateibeendigungsterminal eine Nachricht empfangen wird; in diesem Fall ist die Verarbeitungsbeendigung nämlich bereits abgeschlossen.

Nachrichtenweitergabe

Für jede am Eingangsterminal empfangene Nachricht, die von dem Knoten erfolgreich verarbeitet wurde, wird eine Kopie an das Ausgangsterminal weitergegeben, falls dieses angeschlossen ist. Auf diese Weise ist eine weitere Verarbeitung der Nachricht möglich.

Für jede Nachricht, die beim Dateibeendigungsterminal eingeht und vom Knoten erfolgreich verarbeitet wird, wird an das Datenendeterminal eine Kopie weitergeleitet, sofern diesem ein Nachrichtenfluss zugeordnet ist. Auf diese Weise ist eine weitere Verarbeitung nach der Beendigung der Datei möglich.

Wenn der FileOutput-Knoten eine Nachricht an das Ausgabe- oder das Datenendeterminal weitergibt, werden die Informationen in der Nachrichtenbaumstruktur 'LocalEnvironment.WrittenDestination.File' gespeichert. In der folgenden Tabelle werden die Elemente der Nachrichtenbaumstruktur 'LocalEnvironment.WrittenDestination.File' erläutert:
Tabelle 1.
Elementname Elementdatentyp Description
Verzeichnis CHARACTER Absoluter Verzeichnispfad des Ausgabeverzeichnisses in der vom Dateisystem des Brokers verwendeten Form. Auf Windows-Systemen beispielsweise beginnt der Verzeichnispfad mit dem Laufwerkbuchstabenpräfix (z. B. C:).
Name CHARACTER Dateiname der Ausgabedatei.
Action CHARACTER Mögliche Werte:
  • Replace (Ersetzen), wenn eine Ausgabedatei mit dem gleichen Namen ersetzt wird.
  • Create (Erstellen), wenn eine neue Ausgabedatei erstellt wird.
  • Append (Anhängen), wenn die Nachricht einem Datensatz zugeordnet ist, der an eine Ausgabedatei angehängt ist.
  • Finish (Ende), wenn eine Dateibeendigungsnachricht eingeht und keine Datei vorliegt, die beendet werden kann (wenn z. B. Datensatz 'Gesamte Datei' angegeben ist und eine Nachricht an das Dateibeendigungsterminal gesendet wird).
  • Transmit (Übertragen), wenn die Datei mittels FTP übertragen und danach gelöscht wurde.
Zeitmarke CHARACTER Der Zeitpunkt (Datum und Uhrzeit) in Form einer Zeichenfolge, zu dem der Knoten die Verarbeitung dieser Datei gestartet hat. Dieser Wert wird den Dateinamen der archivierten Dateien als Präfix vorangestellt, wenn auf der Registerkarte Grundeinstellung unter Maßnahme für Ausgabedatei die Option Zeitmarke, bestehende Datei archivieren und ersetzen angegeben ist.

Mehrere Instanzen

Möglicherweise müssen mehrere Nachrichtenflüsse in dieselbe Datei schreiben. Dies kann passieren, wenn es mehr als null zusätzliche Instanzen oder mehrere Flüsse mit FileOutput-Knoten gibt. Der FileOutput-Knoten lässt innerhalb einer Ausführungsgruppe und zwischen mehreren Ausführungsgruppen jeweils nur eine einzige Instanz zu, die eine Datei schreibt. Solange ein Datensatz geschrieben wird (bzw. die Verarbeitungsbeendigung erfolgt), müssen alle anderen Instanzen in der Ausführungsgruppe warten. Die Reihenfolge, in der die Instanzen Zugriff erhalten, ist nicht definiert.

Bei der Verarbeitungsbeendigung gilt, dass die erste Instanz, die Zugriff erhält, den Vorgang ausführt, während die übrigen Instanzen die Datei nicht finden können. Es handelt sich hierbei nicht um einen Fehler im Verarbeitungsablauf. Für alle Instanzen, die die Datei nicht im Durchgangsverzeichnis finden können, wird das Element 'Action' der Nachrichtenbaumstruktur 'LocalEnvironment.WrittenDestination.File' auf Finish (Beenden) gesetzt.

Diesen Knoten in einem Nachrichtenfluss verwenden

Der FileOutput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der Nachrichten in Dateien ausgeben muss. Die folgenden Beispielprogramme verdeutlichen die Verwendung dieses Knotens:
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.

FileOutput-Knoten konfigurieren

Nachdem Sie eine Instanz des FileOutput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den -Knoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. In dieser Ansicht sind alle obligatorischen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert) mit einem Stern markiert.

So konfigurieren Sie einen FileOutput-Knoten:

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Geben Sie auf der Registerkarte Grundeinstellung die Details zu den vom FileOutput-Knoten erstellten Dateien ein.
    1. Geben Sie unter Verzeichnis das Ausgabeverzeichnis an, in das der FileOutput-Knoten seine Dateien ausgeben soll. Geben Sie für das Verzeichnis einen absoluten oder einen relativen Verzeichnispfad an. Ein relativer Verzeichnispfad wird in Bezug auf das in der Umgebungsvariablen MQSI_FILENODES_ROOT_DIRECTORY angegebene Verzeichnis angegeben. Beispiele: unter Windows C:\fileoutput und unter UNIX /var/fileoutput. Wenn die Dateien in das durch MQSI_FILENODES_ROOT_DIRECTORY angegebene Verzeichnis geschrieben werden sollen, müssen Sie in dieser Eigenschaft den Wert angeben.

      Der zu verwendende Pfad für das Ausgabeverzeichnis kann durch Werte in der aktuellen Nachricht überschrieben werden. Weitere Informationen hierzu finden Sie im Abschnitt zur Registerkarte 'Anforderung'.

    2. Geben Sie unter Dateiname oder Muster einen Dateinamen bzw. ein Muster an. Damit legen Sie den Namen der Datei fest, die vom FileOutput-Knoten erstellt werden soll. Hierbei kann es sich entweder um einen bestimmten Dateinamen oder um eine mit einem Dateinamen übereinstimmende Zeichenfolge, also ein Muster, handeln. In diesem Eigenschaftsfeld sind nur Muster mit einem einzigen Platzhalterzeichen (dem Stern '*') zulässig. Der zu verwendende Dateiname wird wie folgt bestimmt:
      • Falls der Dateiname kein Platzhalterzeichen enthält, wird der Wert dieser Eigenschaft als Name der erstellten Datei verwendet. Der Dateiname muss auf dem Dateisystem gültig sein, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird.
      • Enthält der Dateiname ein einziges Platzhalterzeichen, wird dieses Platzhalterzeichen durch den Wert des Elements 'LocalEnvironment.Wildcard.WildcardMatch' in der aktuellen Nachricht ersetzt, und der daraus resultierende Wert ergibt den Namen der erstellten Datei. Der Dateiname muss auf dem Dateisystem gültig sein, auf dem sich der Broker befindet, für den der Nachrichtenfluss implementiert wird. Wird der Wert 'WildcardMatch' nicht gefunden, so wird das Platzhalterzeichen durch die leere Zeichenfolge ersetzt.
      Der Name der Datei kann durch Werte in der aktuellen Nachricht überschrieben werden. Weitere Informationen hierzu finden Sie im Abschnitt zur Registerkarte 'Anforderung'. Falls für die Eigenschaft Dateiname oder Muster kein Wert angegeben ist, muss der Name durch die aktuelle Nachricht überschrieben werden. Zu beachten ist, dass das Platzhalterzeichen nur dann ersetzt wird, wenn die Eigenschaft nicht auf diese Weise überschrieben wird.

      Dateinamen werden an das Dateisystem übergeben, auf das der Broker Zugriff hat. Die Konventionen dieser Dateisysteme müssen berücksichtigt werden. So muss beispielsweise bei Dateinamen in Windows-Systemen Groß-/Kleinschreibung nicht beachtet werden, wogegen in UNIX-Systemen Dateinamen, die in der Groß- und Kleinschreibung voneinander abweichen, als verschiedene Dateinamen angesehen werden.

    3. Geben Sie für Maßnahme für Ausgabedatei an, wie die Datei nach Fertigstellung verarbeitet werden soll. Zur Auswahl stehen:
      • Bestehende Datei ersetzen - Mit dieser Standardeinstellung wird angegeben, dass eine eventuell bereits im Ausgabeverzeichnis vorhandene Datei mit demselben Namen durch die neue Datei ersetzt wird.
      • Datei erstellen - Mit dieser Option wird festgelegt, dass eine neue Datei erstellt werden soll. Wenn bereits eine Datei mit demselben Namen im Ausgabeverzeichnis vorhanden ist, bleibt die neue Datei im Durchgangsverzeichnis, und es wird eine Ausnahmebedingung ausgelöst.
      • Bestehende Datei archivieren und ersetzen - Mit dieser Option wird angegeben, dass eine eventuell bereits im Ausgabeverzeichnis vorhandene Datei mit demselben Namen in das Archivverzeichnis verschoben werden soll, bevor die neue Datei in das Ausgabeverzeichnis gestellt wird.
      • Zeitmarke, bestehende Datei archivieren und ersetzen, um anzugeben, dass dem Dateinamen einer Datei, die in das Archivverzeichnis verschoben werden soll, eine Zeitmarke hinzugefügt werden soll (eine zeichenbasierte Version des Datums und der Uhrzeit), falls im Ausgabeverzeichnis bereits eine Datei mit dem gleichen Namen vorhanden ist.
    4. Markieren Sie das Kontrollkästchen Doppelt vorhandene Archivdateien ersetzen, und geben Sie damit an, dass Dateien, die in das Archivverzeichnis verschoben werden, dort bereits vorhandene Dateien mit demselben Namen ersetzen sollen, wenn unter Maßnahme für Ausgabedatei entweder Bestehende Datei archivieren und ersetzen oder Zeitmarke, bestehende Datei archivieren und ersetzen angegeben ist. Standardmäßig ist dieses Kontrollkästchen nicht ausgewählt. Ist das Kontrollkästchen nicht ausgewählt, bedeutet dies, dass eine Ausnahmebedingung eintritt, wenn der Name einer Datei im Archivverzeichnis mit dem Namen einer dorthin zu verschiebenden Datei identisch ist. Die neue Datei bleibt dann im Durchgangsverzeichnis.
  3. Geben Sie auf der Registerkarte Anforderung den Standort der zu schreibenden Daten an, sowie die Steuerinformationen, mit denen die Eigenschaften Verzeichnis und Dateiname oder Muster der Registerkarte Grundeinstellung überschrieben werden. Die Eigenschaften dieser Registerkarte können Sie als XPath- oder ESQL-Ausdrücke angeben. Zu den Eigenschaften und auch im Erstellungsprogramm für XPath-Ausdrücke stehen Inhaltshilfen zur Verfügung, die Sie mit der Schaltfläche Bearbeiten neben den einzelnen Eigenschaften aufrufen können.
    1. Geben Sie unter Datenposition den Standort der Eingabedaten an. Dies ist die Position in der Baumstruktur für Eingabenachrichten, in welcher der in die Ausgabedatei zu schreibende Datensatz enthalten ist. Der Standardwert ist $Body, d. h. der gesamte Nachrichtenhauptteil ($InputRoot.Body).
      Wenn Sie diese Eigenschaft angeben und die Daten in der Nachrichtenbaumstruktur, die durch diese Eigenschaft angegeben wird, einem modellgesteuerten Parser angehören, beispielsweise einem MRM- oder XMLNSC-Parser, müssen Sie Folgendes berücksichtigen:
      • Wenn Sie das MRM CWF-Format verwenden, müssen Sie sicherstellen, dass die angegebene Nachrichtenbaumstruktur als Nachrichtendefinition vorliegt. Wenn die Struktur nur als globales Element definiert ist, werden die Ausnahmen BIP5180 und BIP5167 generiert.
      • Wenn Sie das MRM TDS-Format verwenden, kann die Serialisierung der angegebenen Nachricht auf jeden Fall erfolgreich durchgeführt werden, unabhängig davon, ob das Element als globales Element oder als Nachricht definiert ist. Wird das angegebene Feld jedoch nicht als globales Element oder als Nachricht gefunden, geschieht Folgendes:
        • Handelt es sich um ein Leaf-Feld innerhalb der Nachrichtenbaumstruktur, so wird das Feld als selbstdefinierend geschrieben. In diesem Fall wird keine Überprüfung durchgeführt, selbst wenn die Prüfung aktiviert ist.
        • Handelt es sich um ein komplexes Element, so wird die interne Ausnahme BIP5522 generiert. Diese weist darauf hin, dass der logische Typ nicht in eine Zeichenfolge konvertiert werden kann.
      • Wenn Sie MRM XML verwenden, entsprechen die Ereignisse dem MRM TDS-Format, außer, wenn es sich um ein komplexes Element handelt. Dieses wird als selbstdefinierend geschrieben.
      • Wenn Sie den XMLNSC-Parser verwenden, wird keine Überprüfung durchgeführt, selbst wenn die Prüfung aktiviert ist.
    2. Geben Sie unter Verzeichniseigenschaft 'Position' anfordern die Position des Wertes an, mit dem die Eigenschaft Verzeichnis auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/Destination/File/Directory. Wenn Sie zwar einen Standort angeben, das Element jedoch leer ist oder fehlt, wird die Eigenschaft Verzeichnis verwendet. Das Element wird wie folgt definiert:
      Element-Datentyp Elementattribute
      CHARACTER Absoluter oder relativer Verzeichnispfad. Verwenden Sie das entsprechende Pfadtrennzeichen ('/' oder '\') für das Dateisystem, auf dem der Broker ausgeführt wird. Abschließende Pfadtrennzeichen werden ignoriert. Relative Verzeichnispfade basieren auf dem Wert der Umgebungsvariablen 'MQSI_FILENODES_ROOT_DIRECTORY'.
    3. Geben Sie unter Verzeichniseigenschaft 'Position' anfordern die Position des Wertes an, mit dem die Eigenschaft Dateiname oder Muster auf der Registerkarte Grundeinstellung überschrieben werden soll. Wenn Sie keinen Standort angeben, lautet der Standardwert $LocalEnvironment/Destination/File/Name. Wenn Sie zwar einen Standort angeben, das Element jedoch leer ist oder fehlt, wird die Eigenschaft Dateiname oder Muster verwendet. Das Element wird wie folgt definiert:
      Element-Datentyp Elementattribute
      CHARACTER Expliziter Dateiname. Platzhalterzeichen werden für diesen Wert nicht ersetzt.
  4. Über die Registerkarte Datensätze und Elemente können Sie angeben, wie der aus der Nachricht abgeleitete Datensatz von dem FileOutput-Knoten geschrieben wird.
    • In Datensatzdefinition stehen folgende Optionen zur Auswahl:
      • Datensatz 'Gesamte Datei' - Mit dieser Option wird angegeben, dass die Datei nur einen einzigen Datensatz enthalten soll. Unmittelbar nachdem der Datensatz geschrieben wurde, wird die Datei beendet; der FileOutput-Knoten wartet nicht auf eine Nachricht am Dateibeendigungsterminal. Dies ist die Standardeinstellung.
      • Datensatz 'Nicht geänderte Daten' - Mit dieser Option wird festgelegt, dass Datensätze in einer Datei akkumuliert werden, wobei weder eine Auffüllung erfolgt noch Begrenzer angewendet werden. Die Datei wird erst beendet, wenn am Dateibeendigungsterminal eine Nachricht empfangen wird.
      • Datensatz 'Daten mit fester Länge' - Bei Verwendung dieser Option werden Datensätze gegebenenfalls bis zu einer festen Länge aufgefüllt und durch Verknüpfung in einer Datei akkumuliert. Die Länge wird in der Eigenschaft Länge definiert. Wenn die Länge des Dokuments den unter Länge angegebenen Wert überschreitet, generiert der Knoten eine Ausnahme. Geben Sie über die Eigenschaft Auffüll-Byte an, welches Byte zum Auffüllen der Nachricht bis zur erforderlichen Länge verwendet werden soll. Die Datei wird erst beendet, wenn am Dateibeendigungsterminal eine Nachricht empfangen wird.
      • Datensatz 'Daten mit Begrenzer' - Mit dieser Option wird angegeben, dass Datensätze durch einen Begrenzer getrennt und durch Verknüpfung akkumuliert werden sollen. Der Begrenzer wird durch die Eigenschaften Begrenzer, Angepasster Begrenzer und Begrenzertyp angegeben. Die Datei wird erst beendet, wenn am Dateibeendigungsterminal eine Nachricht empfangen wird.
    • Geben Sie unter Länge an, wie lang die Datensätze sein sollen (in Bytes), wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. Sind Datensätze länger als hier angegeben, wird eine Ausnahmebedingung ausgelöst. Es muss ein Wert zwischen 1 Byte und 100 MB angegeben werden. Der Standardwert beträgt 80 Bytes.
    • Geben Sie über die Option Auffüll-Byte an, welches Byte zum Auffüllen von Datensätzen verwendet werden soll, die kürzer als angegeben sind, wenn für Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist. Geben Sie dieses Zeichen in Form von 2 Hexadezimalziffern an. Der Standardwert ist X'20'.
    • Geben Sie unter Begrenzer den Begrenzer an, der verwendet werden soll, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben wird. Zur Auswahl stehen:
      • Linienende des Brokersystems - Mit dieser Option wird angegeben, dass eine dem Dateisystem, auf dem der Broker ausgeführt werden soll, entsprechende Zeilenend-Bytefolge als Begrenzer verwendet werden soll. Dies ist die Standardeinstellung. Auf Windows-Systemen handelt es sich hierbei um ein Paar 'Rücklauf, Zeilenvorschub' (X'0D0A'), auf UNIX-Systemen um ein einzelnes 'Zeilenvorschub'-Byte (X'0A') und auf z/OS-Systemen um ein 'Zeilenumbruch'-Byte (X'15').
      • Angepasster Begrenzer - Mit dieser Option wird angegeben, dass mit der in der Eigenschaft Angepasster Begrenzer definierten expliziten Begrenzerfolge Datensätze begrenzt werden sollen.
    • Geben Sie unter Angepasster Begrenzer die Begrenzer-Bytefolge an, mit der Datensätze begrenzt werden sollen, wenn für die Eigenschaft Begrenzer die Option Angepasster Begrenzer angegeben ist. Geben Sie diese als eine geradzahlige Hexadezimalziffernzeichenfolge an. Der Standardwert ist X'0A' und die maximale Länge der Zeichenfolge beträgt 16 Bytes.
    • Wenn Sie unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben haben, geben Sie unter Begrenzertyp an, mit welcher Art von Begrenzer die Datensätze getrennt werden sollen. Zur Auswahl stehen:
      • Postfix - Mit dieser Option wird angegeben, dass nach jedem geschriebenen Datensatz ein Begrenzer eingefügt wird. Dies ist die Standardeinstellung.
      • Infix - Mit dieser Option wird angegeben, dass der Begrenzer zwischen zwei benachbarten Datensätzen eingefügt werden soll.
  5. Geben Sie auf der Registerkarte Auswertung die Eigenschaften für die Parser-Auswertung des Knotens an. Weitere Informationen zur Überprüfung finden Sie unter Nachrichten überprüfen. Weitere Informationen zum Ausfüllen dieser Registerkarte finden Sie unter Eigenschaften der Registerkarte 'Auswertung'.
  6. Aktivieren Sie auf der RegisterkarteFTP das Kontrollkästchen 'FTP', wenn der Knoten Dateien unter Verwendung der File Transfer Protocol-Eigenschaften an einen FTP-Server weiterleiten soll:
    • Geben Sie unter FTP-Server und -Port die Internetadresse und die Portnummer des zu verwendenden FTP-Servers an. Verwenden Sie hierbei folgende Syntax:
      • <IP-Adresse oder URL> oder
      • <IP-Adresse oder URL>:<Portnummer>
      Wenn Sie die Internetadresse im IPv6-Format angeben, muss diese in eckigen Klammern eingeschlossen sein. Beispiel:
      • [12a::13bd:24cd] oder
      • [12a::13bd:24cd]:123, wobei 123 für die Portnummer steht
      Wenn Sie keine Portnummer angeben, wird die Portnummer 21 angenommen. Ist allerdings ein konfigurierbarer FTP-Server-Service definiert, können Sie den Namen des konfigurierbaren Service in dieses Feld eingeben. Informationen dazu, inwiefern sich die Definition eines konfigurierbaren FTP-Server-Service und die Eigenschaften auf dieser Registerkarte gegenseitig beeinflussen, finden Sie im Abschnitt Konfigurierbare Serviceeigenschaften für den FTP-Server.
    • Geben Sie unter Sicherheitsidentität den Namen einer über den Befehl mqsisetdbparms definierten Sicherheitsidentität an. Dieser Definition sind auch die Benutzer-ID und das Kennwort für die Anmeldung beim FTP-Server zu entnehmen. Der Name der Definition sollte mit dem Präfix ftp:: beginnen. Der Wert für die hier beschriebene Eigenschaft wird durch den Wert der Eigenschaft 'securityIdentity' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
    • Geben Sie unter Serververzeichnis das Verzeichnis auf dem FTP-Server an, in das Dateien übertragen werden sollen. Die Standardeinstellung lautet . und bezeichnet das Standardverzeichnis nach der Anmeldung. Wird hierfür ein relativer Pfad angegeben, basiert das betreffende Verzeichnis auf dem Standardverzeichnis nach der Anmeldung beim FTP-Server. Achten Sie darauf, dass die Pfadsyntax mit den Dateisystemstandards auf dem FTP-Server übereinstimmt. Der Wert der hier beschriebenen Eigenschaft wird durch den Wert der Eigenschaft 'remoteDirectory' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
    • Geben Sie unter Übertragungsmodus an, wie die Dateien übertragen werden. Wählen Sie Binär aus, wenn der Dateiinhalt nicht umgewandelt werden muss. Wählen Sie ASCII aus, wenn die Datei im ASCII-Format übertragen werden soll. Der Wert der hier beschriebenen Eigenschaft wird durch den Wert der Eigenschaft 'transferMode' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
    • Aktivieren Sie das Kontrollkästchen Lokale Datei nach Übertragung behalten, wenn Sie nach Abschluss der Dateiübertragung eine lokale Kopie der Datei behalten möchten. Wenn das Kontrollkästchen aktiviert ist, werden die lokalen Kopien nach der Übertragung wie Ausgabedateien gemäß den Einstellungen auf der Registerkarte Grundeinstellung verarbeitet. Wenn das Kontrollkästchen inaktiviert ist, werden erfolgreich übertragene Dateien im lokalen Dateisystem gelöscht.

Terminals und Eigenschaften

In der folgenden Tabelle werden die Terminals des FileOutput-Knotens beschrieben.

Terminal Description
Eingangsterminal Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt.
Datei beenden Das Eingabeterminal, das eine Nachricht annimmt, welche die Beendigung 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.
Datenende Die am Dateibeendigungsterminal empfangene Nachricht wird an dieses Terminal weitergegeben, wenn die Datei erfolgreich beendet wurde.
Fehlerterminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn während der Weitergabe der Nachricht ein Fehler auftritt.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des FileOutput-Knotens beschrieben:
Eigenschaft M C Standardwert Description
Knotenname Nein Nein FileOutput Der Name des Knotens.
Kurzbeschreibung Nein Nein   Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein   Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

In der folgenden Tabelle werden die Grundeinstellungseigenschaften des FileOutput-Knotens beschrieben:

Eigenschaft M C Standardwert Description
Verzeichnis Nein Ja None (Keinen) Das Verzeichnis, in das der Knoten seine Dateien ablegt.
Dateiname oder Muster Nein Ja None (Keinen) Der bestimmte Dateiname oder ein Muster mit einem Platzhalterzeichen; definiert den Namen der zu erstellenden Datei.
Maßnahme für Ausgabedatei Ja Nein Bestehende Datei ersetzen Gibt an, welche Aktion bei Beendigung der Ausgabedatei erfolgen soll. Folgende Optionen sind gültig:
  • Bestehende Datei ersetzen
  • Datei erstellen
  • Bestehende Datei archivieren und ersetzen
  • Zeitmarke, bestehende Datei archivieren und ersetzen
Doppelt vorhandene Archivdatei ersetzen Ja Nein Nicht ausgewählt Gibt an, ob Dateien im Archivverzeichnis durch gleichnamige Dateien, die dorthin verschoben werden, ersetzt werden dürfen.

In der folgenden Tabelle werden die Anforderungseigenschaften des FileOutput-Knotens beschrieben:

Eigenschaft M C Standardwert Description
Datenposition Ja Nein $Body Die Position in der Baumstruktur für Eingabenachrichten, in welcher der in die Ausgabedatei geschriebene Datensatz enthalten ist.
Verzeichniseigenschaft 'Position' anfordern Ja Ja $LocalEnvironment/Destination/File/Directory Die Nachrichtenelementposition, in welcher der Name des Ausgabeverzeichnisses enthalten ist.
Dateinameneigenschaft 'Position' anfordern Ja Ja $LocalEnvironment/Destination/File/Name Die Nachrichtenelementposition, in welcher der Name der Ausgabedatei enthalten ist.

In der folgenden Tabelle werden die Dokument- und Elementeigenschaften des FileOutput-Knotens beschrieben:

Eigenschaft M C Standardwert Description
Dokumentdefinition Ja Nein Datensatz 'Gesamte Datei' Über diese Eigenschaft wird gesteuert, wie die 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 Ja Nein 80 Die erforderliche Länge des Ausgabesatzes. Diese Eigenschaft ist nur anwendbar, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist.
Auffüll-Byte Ja Nein X'20' Das aus zwei Hexadezimalzeichen bestehende Byte, mit dem kurze Nachrichten aufgefüllt werden, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit fester Länge' angegeben ist.
Begrenzer Ja Nein Linienende des Brokersystems Der zu verwendende Begrenzer, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben ist. Folgende Optionen sind gültig:
  • Linienende des Brokersystems
  • Angepasster Begrenzer
Benutzerspezifischer Begrenzer Nein Nein None (Keinen) Die als Begrenzer dienende Bytefolge, die zu verwenden ist, wenn für die Eigenschaft Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' und für die Eigenschaft Begrenzer die Option Angepasster Begrenzer angegeben ist.
Begrenzertyp Ja Nein Postfix Mit dieser Eigenschaft wird angegeben, wie Begrenzer zwischen den einzelnen Datensätzen eingefügt werden, wenn unter Datensatzdefinition die Option Datensatz 'Daten mit Begrenzer' angegeben ist. Folgende Optionen sind gültig:
  • Postfix
  • Infix

In der folgenden Tabelle werden die Validierungseigenschaften des FileOutput-Knotens beschrieben.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Description
Auswertung Nein Ja Übernehmen Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Keines
  • Inhalt und Wert
  • Inhalt
  • Übernehmen
Fehlerbehebungsmaßnahme Nein Nein Exception 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
  • Ausnahme
  • Ausnahmelistet

In der folgenden Tabelle werden die FTP-Eigenschaften des FileOutput-Knotens beschrieben:

Eigenschaft M C Standardwert Description
FTP Nein Nein Nicht ausgewählt Mit dieser Eigenschaft wird festgelegt, ob der Knoten die auf der Registerkarte FTP aufgeführten FTP-Eigenschaften verwendet und Dateien auf einen FTP-Server überträgt.
FTP-Server und -Port Nein Ja None (Keinen) Die IP-Adresse oder der Name (und wahlweise auch die Portnummer) eines fernen FTP-Servers (z. B. ftp.server.com:21) oder der Name eines konfigurierbaren Service vom Typ 'FtpServer'. Bei Angabe des Namens eines konfigurierbaren Service können die folgenden FTP-Eigenschaften komplett oder teilweise von dem konfigurierbaren Service überschrieben werden.
Sicherheitsidentität Nein Ja None (Keinen) Der Name der Benutzer-ID, die für den Zugriff auf den FTP-Server verwendet wird. Diese Eigenschaft wird mit der Eigenschaft 'securityIdentity' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Serververzeichnis Nein Ja "." Das Verzeichnis auf dem FTP-Server, in das Dateien übertragen werden sollen. Wird hierfür ein relativer Pfad angegeben, bezieht sich dieser auf das Ausgangsverzeichnis nach der Anmeldung. Diese Eigenschaft wird mit der Eigenschaft 'remoteDirectory' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Übertragungsmodus Nein Ja Binär Der FTP-Übertragungsmodus für die Übertragung von Dateidaten. Folgende Optionen sind gültig:
  • Binär
  • ASCII
Diese Eigenschaft wird mit der Eigenschaft 'transferMode' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.
Lokale Datei nach Übertragung behalten Nein Nein Nicht ausgewählt Ist dieses Kontrollkästchen aktiviert, wird von einer Datei, die auf einen fernen FTP-Server übertragen wurde, eine lokale Kopie behalten und gemäß den Angaben zur Dateidisposition auf der Registerkarte Grundeinstellung in das Ausgabeverzeichnis gestellt. Ist dieses Kontrollkästchen nicht ausgewählt, werden von Dateien, die auf einen fernen FTP-Server übertragen wurden, keine lokalen Kopien behalten.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55160_