FileInput-Knoten

Mit dem FileInput-Knoten können Sie Nachrichten verarbeiten, die aus Dateien gelesen werden.

Zweck

Aus einer einzigen Datei können eine oder mehrere Nachrichten gelesen werden. Die Nachrichten werden jeweils als separate Nachrichtenflusstransaktion weitergeleitet. Der Teil einer Datei, der eine Nachrichtenflusstransaktion generiert, wird als Datensatz bezeichnet. Eine Datei kann ein einzelner Datensatz oder eine Folge von Datensätzen sein. Die Eigenschaften im Knoten geben an, wie der FileInput-Knoten die Datensätze in einer Datei bestimmt.

Der FileInput-Knoten befindet sich im Ablagefach Datei der Palette und wird im WebSphere Message Broker Toolkit durch folgendes Symbol dargestellt:

Symbol für FileInput-Knoten

Nachrichtenstruktur

Der FileInput-Knoten bearbeitet Nachrichten in den folgenden Nachrichtendomänen:
  • DFDL
  • XMLNSC
  • DataObject
  • JSON
  • BLOB (Binary large object)
  • MIME
  • MRM
  • JMSMap
  • JMSStream
  • XMLNS

Wenn der FileInput-Knoten eine Nachricht weitergibt, werden die Informationen zu der Nachricht in der Nachrichtenbaumstruktur 'LocalEnvironment.File' gespeichert. Wenn die Eingabedatei leer ist, wird eine leere Nachricht verbreitet (und vorausgesetzt, dass die Datei gültig ist). In der folgenden Tabelle ist die Nachrichtenbaumstruktur von 'LocalEnvironment.File' aufgeführt. Die Elemente enthalten Daten zum aktuellen Datensatz.

Elementname Elementdatentyp Beschreibung
Directory CHARACTER Absoluter Verzeichnispfad des Eingabeverzeichnisses 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 und Erweiterung.
LastModified TIMESTAMP Datum und Uhrzeit der letzten Änderung.
TimeStamp CHARACTER Der Zeitpunkt (Datum und Uhrzeit) in der Weltzeit (UTC), an dem der Empfangsknoten die Verarbeitung der Datei gestartet hat, als Zeichenfolge. Anhand dieser Daten werden die Namen von Archiv- und Backout-Dateien erstellt, wenn diese Namen eine Zeitmarke enthalten.
Die folgenden Elemente enthalten Daten zum aktuellen Datensatz:
Offset INTEGER (Ganze Zahl) Der Anfang des Datensatzes innerhalb der Datei. Der erste Datensatz startet bei der relativen Position 0. Wenn 'Offset' Teil der Datenende-Nachrichtenbaumstruktur ist, entspricht dieser Wert der Länge der Eingabedatei.
Record INTEGER (Ganze Zahl) Die Nummer des Datensatzes innerhalb der Datei. Der erste Datensatz startet bei Satznummer 1. Wenn 'Record' Teil der Datenende-Nachrichtenbaumstruktur ist, entspricht dieser Wert der Anzahl der Datensätze.
Begrenzer CHARACTER Die Zeichen, die zur Trennung dieses Datensatzes vom vorhergehenden Datensatz verwendet werden, wenn für DatensatzerkennungMit Begrenzer angegeben ist. Der erste Datensatz hat einen Begrenzer von null. Wenn 'Begrenzer' Teil der Datenende-Nachrichtenbaumstruktur ist, entspricht dieser Wert dem auf den letzten Datensatz folgenden Begrenzer, sofern vorhanden.
IsEmpty BOOLEAN Gibt an, ob der vom Nachrichtenfluss weitergeleitete Datensatz leer ist. 'IsEmpty' ist auf TRUE gesetzt, wenn der aktuelle Datensatz leer ist. Wenn 'IsEmpty' Teil der Datenende-Nachrichtenbaumstruktur ist, ist diese Eigenschaft immer auf TRUE gesetzt.

Diesen Knoten in einem Nachrichtenfluss verwenden

Der FileInput-Knoten kann in jedem Nachrichtenfluss verwendet werden, der Nachrichten in Dateien annehmen muss. Die folgenden Mustercodes verdeutlichen die Verwendung dieses Knotens:

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.

Wenn Sie einen Dateiknoten für die Verwendung von FTP konfigurieren, muss er in Ihrem Netz möglicherweise mit einem FTP-Proxy-Server statt direkt mit dem fernen FTP-Server verbunden werden. Die genaue Konfiguration der Dateiknoten für die Verwendung eines FTP-Proxys ist davon abhängig, wie der betreffende Proxy Anforderungen bearbeitet. Für einige FTP-Proxys müssen Sie die FTP-Zielserverinformationen in den Anmeldeberechtigungsnachweisen codieren, die Sie mit dem Befehl mqsisetdbparms erstellen. Einige Proxys unterstützen beispielsweise die folgenden Werte:
Benutzername: FTP-Zielhostbenutzername@Proxy-Benutzername@Ziel-FTP-Hostname 
Kennwort: Ziel-FTP-Benutzerkennwort@Proxy-Benutzerkennwort
Andere Proxys erwarten möglicherweise andere Codierungen oder machen eine externe Konfiguration erforderlich; andernfalls sind Sie möglicherweise nicht in Verbindung mit den Dateiknoten verwendbar.

FileInput-Knoten konfigurieren

Nachdem Sie eine Instanz des FileInput-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt. Alle verbindlichen Eigenschaften, für die Sie einen Wert eingeben müssen (d. h. Eigenschaften ohne definierten Standardwert), sind mit einem Stern gekennzeichnet.

Konfigurieren Sie den FileInput-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 Verzeichnisse und Dateien ein, die von dem FileInput-Knoten verarbeitet werden sollen, und legen Sie außerdem fest, was mit doppelt vorhandenen Dateien geschehen soll.
    • Geben Sie unter Eingabeverzeichnis das Verzeichnis an, aus dem der FileInput-Knoten Dateien erhält. Geben Sie als Verzeichnis entweder 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. Ein Beispiel auf Windows-Systemen ist C:\fileinput. Ein Beispiel auf UNIX-Systemen ist /var/fileinput.

      Der FileInput-Knoten erstellt im angegebenen Eingabeverzeichnis ein Unterverzeichnis mqsitransitin. In diesem Unterverzeichnis bleiben Eingabedateien während der Verarbeitung gesperrt. Wenn eine Ausführungsgruppe, die Dateien in diesem Eingabeverzeichnis verarbeitet, entfernt wird, müssen Sie unbedingt prüfen, ob sich im Unterverzeichnis mqsitransitin teilweise oder nicht verarbeitete Dateien befinden. Verschieben Sie derartige Dateien wieder in das Eingabeverzeichnis (und entfernen Sie das UUID-Ausführungsgruppenpräfix aus den Dateinamen), damit sie von einer anderen Ausführungsgruppe verarbeitet werden können. Weitere Informationen zum Unterverzeichnis mqsitransitin finden Sie unter Gemeinsamer Zugriff auf Dateien in demselben Verzeichnis durch mehrere Dateien.

    • Wählen Sie Lokale Unterverzeichnisse einschließen aus, wenn Dateien in der Verzeichnisstruktur unter Eingabeverzeichnis verarbeitet werden sollen. Der Broker muss Zugriff auf das angegebene Basisverzeichnis haben. Wenn der Broker keinen Zugriff auf ein bestimmtes Unterverzeichnis hat, wird das betreffende Unterverzeichnis nicht durchsucht und es wird eine Nachricht in den Benutzertrace geschrieben. Dateien werden nach ihrem Alter verarbeitet, d. h., die ältesten Dateien werden zuerst verarbeitet, unabhängig davon, an welcher Position in der Verzeichnisstruktur sie stehen. Die Entscheidung, ob Dateien verarbeitet oder ignoriert werden, wird erstens abhängig vom Dateinamen oder -muster und zweitens abhängig vom Dateiausschlussmuster gefällt.

      Wenn Sie sowohl die Eigenschaft Lokale Unterverzeichnisse einschließen als auch die Eigenschaft Fernübertragung auswählen, werden nur die Unterverzeichnisse auf dem lokalen System nach zu verarbeitenden Dateien durchsucht. Auf dem fernen System wird dagegen nur das Basisverzeichnis, das Sie angegeben haben, nach zu verarbeitenden Dateien durchsucht.

    • Geben Sie unter Dateiname oder Muster ein Muster für den Dateinamen an. Dabei kann es sich entweder um einen Dateinamen oder um eine mit einem Dateinamen übereinstimmende Zeichenfolge (ein Muster) handeln. Ein Muster ist eine Zeichenfolge mit mindestens einem der folgenden Platzhalterzeichen:
      Platzhalterzeichen Beschreibung Beispiel
      * Beliebige Folge von null oder mehr Zeichen *.xml stimmt mit allen Dateinamen überein, deren Erweiterung xml lautet.
      ? Beliebiges einzelnes Zeichen f??????.csv stimmt mit allen Dateinamen überein, die mit dem Buchstaben f beginnen, sechs weitere Zeichen umfassen und die Erweiterung .csv haben.
      Damit eine Datei verarbeitet wird, muss sie mit dem Muster übereinstimmen.

      Wenn Sie ein Dateinamensmuster mit Platzhalterzeichen angeben, kopiert der FileInput-Knoten die Zeichen des Dateinamens, die den Platzhalterzeichen entsprechen, sowie alle dazwischen liegenden Zeichen in das Feld 'LocalEnvironment.Wildcard.WildcardMatch'. Weitere Informationen finden Sie im Abschnitt Dateinamensmuster.

    • Geben Sie in Dateiausschlussmuster ein Muster für Dateinamen an, die Sie von der Verarbeitung ausschließen möchten. Geben Sie entweder einen Dateinamen oder eine Zeichenfolge (ein Muster), die einem Dateinamen entspricht, an. Ein Muster ist eine Zeichenfolge, die mindestens eins der unter Platzhalterzeichen aufgeführten Platzhalterzeichen enthält. Damit eine Datei von der Verarbeitung ausgeschlossen wird, muss ihr Name mit dem Muster übereinstimmen.
    • Wählen Sie Maßnahme bei erfolgreicher Verarbeitung aus, und geben Sie an, wie der FileInput-Knoten nach erfolgreicher Verarbeitung der Datei vorgehen soll. Hierbei sind folgende Maßnahmen möglich: die Datei kann in das Archivunterverzeichnis verschoben werden, der Dateiname kann mit einer Zeitmarke erweitert und die Quellendatei dann in das Archivunterverzeichnis verschoben werden oder die Datei kann gelöscht werden.
      • Wenn Sie In Unterverzeichnis des Archivs verschieben auswählen, wird die Quellendatei in das Unterverzeichnis des Archivs des Eingabeverzeichnisses verschoben. Der Name des Unterverzeichnisses lautet mqsiarchive. Bei einem Eingabeverzeichnis /var/fileinput lautet der absolute Pfad des Unterverzeichnisses für die Zurücksetzung beispielsweise /var/fileinput/mqsiarchive. Wenn dieses Verzeichnis nicht vorhanden ist, wird es vom Broker beim ersten Versuch, eine Datei in das Verzeichnis zu verschieben, erstellt.
      • Bei Auswahl von Zeitmarke hinzufügen und in Unterverzeichnis des Archivs verschieben wird der Dateiname um das aktuelle Datum und die aktuelle Uhrzeit erweitert und die Datei anschließend in das Verzeichnis mqsiarchive verschoben.
      • Bei Auswahl von Löschen wird die Datei nach erfolgreicher Verarbeitung gelöscht.
      Wenn die Tracefunktion für Benutzer aktiviert ist, schreibt der FileInput-Knoten jedes Mal, wenn er eine Datei verarbeitet, eine Nachricht in den Benutzertrace.
    • Wählen Sie Doppelt vorhandene Archivdateien ersetzen aus, wenn eine Datei im Archivunterverzeichnis durch eine erfolgreich verarbeitete Datei mit demselben Namen ersetzt werden soll. Wenn Sie diese Option nicht festlegen und in dem Archivunterverzeichnis bereits eine Datei mit demselben Namen vorhanden ist, löst der Knoten beim Versuch, die erfolgreich verarbeitete Datei zu verschieben, eine Ausnahme aus.
  3. Legen Sie auf der Registerkarte Syntaxanalyse der Eingabenachricht Werte für die Eigenschaften fest, anhand derer der Knoten feststellt, wie die eingehende Nachricht analysiert werden soll.
    • Wählen Sie in der Liste unter Nachrichtendomäne den Namen des von Ihnen verwendeten Parsers aus. Der Standardwert ist BLOB. Folgende Optionen stehen zur Auswahl:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB (Binary large object)
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS
      Sie können bei Bedarf auch einen benutzerdefinierten Parser angeben.
    • Wenn Sie den DFDL-, den MRM- oder den XMLNSC-Parser im Prüfungsmodus verwenden, wählen Sie das relevante Nachrichtenmodell aus der Liste aus. Diese Liste wird mit den verfügbaren Nachrichtengruppen gefüllt, wenn Sie MRM oder XMLNSC als Nachrichtendomäne auswählen, bzw. mit den verfügbaren DFDL-Schemadateien, wenn Sie DFDL als Nachrichtendomäne auswählen.
    • Wenn Sie den DFDL- oder den MRM-Parser verwenden, wählen Sie die korrekte Nachricht aus der Liste Nachricht aus. Diese Liste wird mit den im ausgewählten Nachrichtenmodell definierten Nachrichten gefüllt.
    • Wenn Sie den MRM-Parser verwenden, wählen Sie das Format der Nachricht aus der Liste Physisches Format aus. Diese Liste enthält alle für dieses Nachrichtenmodell definierten physischen Formate.
    • Geben Sie in ID der codierten Nachrichtengruppe die ID der codierten Nachrichtengruppe an.
    • Wählen Sie aus der Liste unter Nachrichtencodierung die Nachrichtencodierung aus, oder geben Sie einen numerischen Codierungswert ein. Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung.
  4. Auf der untergeordneten Registerkarte Parser-Optionen:
    • Die Option Zeitpunkt für Syntaxanalyse ist standardmäßig auf Bei Bedarf gesetzt, d. h., die Analyse der Nachricht wird verschoben. Wenn die vollständige Nachricht sofort syntaktisch analysiert werden soll, setzen Sie diese Eigenschaft auf Sofort oder Vollständig. Weitere Informationen finden Sie unter Bedarfsgerechte Syntaxanalyse.
    • Wenn Sie den XMLNSC-Parser verwenden, legen Sie die Werte für die Eigenschaften fest, die bestimmen, wie der XMLNSC-Parser vorgeht. Weitere Informationen hierzu finden Sie im Abschnitt Nachrichten in der XMLNSC-Domäne bearbeiten.
  5. Geben Sie auf der Registerkarte Abfrage einen Wert für das Abfrageintervall ein. Über diese Eigenschaft wird gesteuert, wie oft der FileInput-Knoten auf das Dateisystem zugreift, um nach zu verarbeitenden Dateien zu suchen.

    Nach dem ursprünglichen Verzeichnissuchlauf beim Starten des Nachrichtenflusses wartet der FileInput-Knoten den über diese Eigenschaft definierten Zeitraum, wenn in dem Verzeichnis keine dem Eingabemuster entsprechenden Dateien gefunden werden. Auf diese Weise wird vermieden, dass der FileInput-Knoten immer wieder auf das Dateisystem zugreift, ein Vorgang, bei dem umfangreiche Systemressourcen benötigt werden.

    Je kleiner der für diese Eigenschaft festgelegte Wert, desto schneller erkennt der FileInput-Knoten Dateien im Eingabeverzeichnis. Ein kleinerer Wert erhöht jedoch die Auslastung von Systemressourcen. Wenn ein größerer Wert definiert ist, sind weniger Systemressourcen erforderlich, jedoch werden zu verarbeitende Dateien vom FileInput-Knoten später erkannt.

    Diese Eigenschaft sollte nicht zur Arbeitsregulierung oder zur Verarbeitungsplanung eingesetzt werden. Wenn der FileInput-Knoten das Eingabeverzeichnis nur zu bestimmten Zeiten überwachen soll, starten und stoppen Sie den Nachrichtenfluss zu den entsprechenden Zeiten.

    Wenn Sie auf der Registerkarte 'FTP' die Eigenschaft Fernübertragung auswählen und die Eigenschaft Scan-Verzögerung festlegen, wird der für Abfrageintervall festgesetzte Wert mit dem Wert überschrieben, den Sie für Scan-Verzögerung angeben.

  6. Auf der Registerkarte Wiederholung können Sie die Wiederholungsverarbeitung definieren, wenn ein Nachrichtenfluss fehlschlägt:
    • Über die Option Wiederholungsmechanismus wird festgelegt, welche Aktion ausgeführt werden soll, wenn der Fluss fehlschlägt:
      • Wählen Sie Fehler aus, wenn der Knoten einen Fehler melden, jedoch keine Wiederholungsversuche starten soll.
      • Wählen Sie Kurze Wiederholungszeit aus, wenn der Knoten bei Fortbestehen der Bedingung den Versuch wiederholen soll, bevor ein Fehler gemeldet wird. Wie oft eine Wiederholung erfolgt, ist durch den Wiederholungsschwellenwert festgelegt.
      • Wählen Sie Kurze und lange Wiederholungszeit aus, wenn der Knoten zunächst die unter Wiederholungsschwellenwert angegebene Anzahl an Wiederholungen ausführen soll. Falls das Problem auch nach Erreichen des Wiederholungsschwellenwerts bestehen bleibt, wartet der Knoten zwischen den einzelnen Versuchen den unter Langes Wiederholungsintervall angegebenen Zeitraum.
    • Geben Sie einen Wert für die Eigenschaft Wiederholungsschwellenwert an. Die Anzahl der Wiederholungsversuche, die der Knoten für die Nachrichtenflusstransaktion startet, wenn die Eigenschaft Wiederholungsmechanismus auf Kurze Wiederholungszeit oder Kurze und lange Wiederholungszeit gesetzt ist.
    • Geben Sie einen Wert für die Eigenschaft Kurzes Wiederholungsintervall an. Dies ist die Zeitspanne in Sekunden zwischen den Versuchen mit kurzer Wiederholungszeit.
    • Geben Sie einen Wert für die Eigenschaft Langes Wiederholungsintervall an. Dieser Wert gibt an, wie lange zwischen den einzelnen Versuchen mit langer Wiederholungszeit gewartet werden soll, bis eine Nachricht erfolgreich ist, der Nachrichtenfluss gestoppt oder erneut implementiert wird. Über die Brokereigenschaft MinLongRetryInterval wird der Mindestwert für die Eigenschaft Langes Wiederholungsintervall definiert. Wenn der Wert diesen Mindestwert unterschreitet, wird der Brokerwert verwendet.
    • Geben Sie einen Wert für die Eigenschaft Maßnahme bei fehlschlagender Datei an und legen Sie damit fest, wie der Knoten mit der Eingabedatei verfahren soll, wenn alle Versuche, deren Inhalt zu verarbeiten, fehlgeschlagen sind:
      • In Unterverzeichnis für die Zurücksetzung verschieben. Die Datei wird in das Backout-Unterverzeichnis des Eingabeverzeichnisses verschoben. Der Name dieses Unterverzeichnisses lautet mqsibackout. Bei einem Eingabeverzeichnis /var/fileinput lautet der absolute Pfad des Unterverzeichnisses für die Zurücksetzung beispielsweise /var/fileinput/mqsibackout. Wenn dieses Unterverzeichnis nicht vorhanden ist, wird es vom Broker beim ersten Versuch, eine Datei in das Verzeichnis zu verschieben, erstellt. Falls die Datei nicht in dieses Unterverzeichnis verschoben werden kann, weil dort möglicherweise bereits eine gleichnamige Datei vorhanden ist, fügt der Knoten dem Dateinamen das aktuelle Datum und die Uhrzeit hinzu und versucht erneut, die Datei zu verschieben. Schlägt auch dieser zweite Versuch fehl, stoppt der Knoten die Verarbeitung. Es werden die Nachrichten BIP3331 und BIP3325 ausgegeben. Beheben Sie das Problem mit dem Unterverzeichnis oder der Datei, bevor Sie den Nachrichtenfluss erneut starten.
      • Löschen. Die Datei wird nach einem Fehlschlagen der Verarbeitung gelöscht.
      • Zeitmarke hinzufügen und in Unterverzeichnis für Zurücksetzung verschieben. Dem Dateinamen werden das aktuelle Datum und die aktuelle Uhrzeit hinzugefügt, und anschließend wird die Datei in das Verzeichnis für die Zurücksetzung verschoben.
  7. Geben Sie auf der Registerkarte Datensätze und Elemente an, wie die einzelnen Dateien als Datensätze interpretiert werden:
    • Geben Sie mit der Eigenschaft Datensatzerkennung an, wie die Datei in Datensätze aufgeteilt wird, aus denen dann die einzelnen Nachrichten generiert werden. Folgende Optionen stehen zur Auswahl:
      • Gesamte Datei - die gesamte Datei bildet einen einzigen Datensatz.
      • Feste Länge - jeder Datensatz umfasst eine festgelegte Anzahl Bytes. Jeder Datensatz enthält die in der Eigenschaft Länge angegebene Bytezahl, lediglich der letzte Datensatz in der Datei kann möglicherweise kürzer sein.
      • Wählen Sie Mit Begrenzer aus, wenn die verarbeiteten Datensätze durch ein DOS- oder UNIX-Zeilenende bzw. durch eine Folge benutzerdefinierter Begrenzerbytes getrennt bzw. beendet werden. Geben Sie für die Eigenschaften Begrenzer und Begrenzertyp den Begrenzer und den Begrenzertyp an.
      • Wählen Sie die Option Syntaktisch analysierte Folge aus, wenn die Datei eine Folge von einem oder mehreren Datensätzen enthält, die von dem unter Nachrichtendomäne angegebenen Parser seriell erkannt werden. Die einzelnen erkannten Datensätze werden vom Knoten jeweils als separate Nachrichten weitergegeben. Bei Auswahl der Option Datensatzerkennung muss unter Nachrichtendomäne entweder ein XMLNSC- oder ein MRM-Parser angegeben sein (das physische Format muss CWF oder TDS sein).
    • Falls Sie für die Eigenschaft Datensatzerkennung Feste Länge angegeben haben, muss unter Länge die erforderliche Länge des Ausgabesatzes in Bytes angegeben werden. Dieser Wert muss im Bereich zwischen 1 Byte und 100 MB liegen. Der Standardwert beträgt 80 Bytes.

      Wenn Sie unter Datensatzerkennung die Option Gesamte Datei, Feste Länge oder Mit Begrenzer angeben, gilt für die Datensätze eine Längenbeschränkung von 100 MB. Wenn Sie unter Datensatzerkennung die Option Syntaktisch analysierte Folge angeben, führt der FileInput-Knoten keine Ermittlung der Datensatzlänge durch und beschränkt diese auch nicht. Die im Nachrichtenfluss nachgeordneten Knoten können die Datensatzlänge entweder ermitteln oder lange Datensätze verarbeiten. Wenn lange Datensätze auf diese Weise verarbeitet werden sollen, müssen Sie sicherstellen, dass Ihr Broker über ausreichend Arbeitsspeicher verfügt. Um den verfügbaren Speicher optimal zu nutzen, müssen möglicherweise die im Beispiel für umfangreiche Nachrichtenausgaben beschriebenen Nachrichtenflusstechniken angewandt werden.

    • Wenn Sie unter Datensatzerkennung Mit Begrenzer angeben, müssen Sie unter Begrenzer den zu verwendenden Begrenzer angeben. Zur Auswahl stehen:
      • DOS- oder UNIX-Zeilenende: Diese Option gibt auf UNIX-Systemen das Zeilenvorschubzeichen (<LF>, X'0A') und auf Windows-Systemen ein Rücklaufzeichen gefolgt von einem Zeilenvorschubzeichen (<CR><LF>, X'0D0A') an. Der Knoten behandelt beide Zeichenfolgen als Begrenzer, unabhängig davon, auf welchem System der Broker ausgeführt wird. Falls beide Zeichenfolgen in der gleichen Datei stehen, erkennt der Knoten beide als Begrenzer. X'15' wird vom Knoten hingegen nicht erkannt. Diese Zeichenfolge steht auf z/OS-Systemen für das Neue-Zeilen-Byte. Wenn Ihre Eingabedatei mit der EBCDIC-Zeichenfolge für neue Zeilen codiert ist, wie dies beispielsweise bei EBCDIC-Dateien von z/OS-Systemen der Fall ist, müssen Sie für diese Eigenschaft den Wert Angepasster Begrenzer sowie für die Eigenschaft Angepasster Begrenzer den Wert 15 angeben.
      • Angepasster Begrenzer: Hier können Sie für Angepasster Begrenzer eine Bytefolge angeben.
    • Geben Sie unter Angepasster Begrenzer das bzw. die Begrenzerbyte(s) an, das/die verwendet werden soll(en), wenn für die Eigenschaft Begrenzer die Option Angepasster Begrenzer festgelegt ist. Geben Sie diesen Wert als geradzahlige Zeichenfolge mit Hexadezimalziffern an. Der Standardwert ist X'0A', die maximale Länge der Zeichenfolge beträgt 16 Bytes (dargestellt durch 32 Hexadezimalziffern).
    • Wenn Sie unter Datensatzerkennung Mit Begrenzer angeben, müssen Sie unter Begrenzertyp den zu verwendenden Begrenzertyp angeben. Gültige Werte sind:
      • Infix. Bei Auswahl dieses Wertes trennt jeder Begrenzer zwei Datensätze. Wenn die Datei mit einem Begrenzer endet, wird der Dateiinhalt mit der Länge null, der hinter dem letzten Begrenzer steht, ebenfalls als Nachricht weitergegeben, obwohl er keine Daten enthält.
      • Postfix. Bei Angabe dieses Wertes beendet jeder Begrenzer einen Datensatz. Wenn die Datei mit einem Begrenzer endet, wird kein leerer Datensatz nach dem Begrenzer weitergegeben. Endet die Datei nicht mit einem Begrenzer, wird sie genauso verarbeitet, als würde hinter den letzten Bytes der Datei ein Begrenzer folgen. Postfix ist der Standardwert.
    • Der FileInput-Knoten betrachtet die einzelnen Vorkommen des Begrenzers in der Eingabedatei als Trennzeichen (Infix) oder als Beendigungszeichen (Postfix) für die einzelnen Datensätze. Wenn die Datei mit einem Begrenzer beginnt, behandelt der Knoten den Dateiinhalt (der Länge null) vor diesem Begrenzer als Datensatz und gibt somit einen leeren Datensatz an den Fluss weiter. Der Begrenzer wird niemals in die weitergegebene Nachricht aufgenommen.
  8. Nehmen Sie über die Registerkarte Auswertung eine Auswertung anhand der Nachrichtengruppe für vordefinierte Nachrichten vor. Weitere Informationen zur Auswertung finden Sie im Abschnitt Nachrichten überprüfen. Informationen zum Ausfüllen dieser Registerkarte finden Sie im Abschnitt Eigenschaften der Registerkarte 'Auswertung'.
  9. Wählen Sie auf der Registerkarte FTP die Eigenschaft Fernübertragung aus, wenn der Knoten Dateien von einem FTP- oder SFTP-Server unter Verwendung der folgenden Eigenschaften lesen soll:
    • Geben Sie als Übertragungsprotokoll das Protokoll an, das für Dateiübertragungen über Fernzugriff verwendet werden soll. Gültige Werte sind FTP und SFTP.
    • Geben Sie unter Ferner Server und Port die IP-Adresse und Portnummer des FTP- oder SFTP-Servers an. Folgende Syntax kann verwendet werden:
      • IP-Adresse_oder_URL
      • IP-Adresse_oder_URL:Portnummer
      Wenn Sie die IP-Adresse im IPv6-Format angeben, muss sie in eckige Klammern gesetzt werden, wie in den folgenden Beispielen dargestellt:
      • [12a::13bd:24cd]
      • [12a::13bd:24cd]:123, wobei 123 für die Portnummer steht
      Wenn Sie bei Verwendung von FTP keine Portnummer angeben, wird Portnummer 21 vorausgesetzt. Wenn Sie bei Verwendung von SFTP keine Portnummer angeben, wird die Portnummer 22 angenommen. Ist allerdings ein konfigurierbarer FTP-Server-Service definiert, können Sie in diesem Feld den Namen des konfigurierbaren Service eingeben. Informationen dazu, wie 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 mit dem Befehl mqsisetdbparms definierten Sicherheitsidentität an. Dieser Definition, deren Bezeichnung das Präfix ftp:: vorangestellt sein muss, werden die Benutzer-ID und das Kennwort entnommen, mit denen die Anmeldung am FTP- oder SFTP-Server erfolgen soll. Der Wert dieser Eigenschaft wird durch den Wert der Eigenschaft 'secureIdentity' des konfigurierbaren FTP-Server-Service überschrieben, falls ein Wert festgelegt ist.
    • Geben Sie unter Serververzeichnis das Verzeichnis auf dem FTP- oder SFTP-Server an, aus dem Dateien übertragen werden sollen. Der Standardwert ist ein Punkt (.) und bezeichnet das Standardverzeichnis nach der Anmeldung. Wenn Sie einen relativen Pfad angeben, basiert das Verzeichnis auf dem Standardverzeichnis nach der FTP- oder SFTP-Anmeldung. Achten Sie darauf, dass die Pfadsyntax mit den Dateisystemstandards auf dem FTP- oder SFTP-Server übereinstimmt. Der Wert der hier beschriebenen Eigenschaft wird durch den Wert der Eigenschaft 'remoteDirectory' des konfigurierbaren FTP-Server-Service überschrieben, falls ein Wert festgelegt ist.

      Wenn Sie sowohl die Eigenschaft Fernübertragung als auch die Eigenschaft Lokale Unterverzeichnisse einschließen auswählen, werden nur die Unterverzeichnisse auf dem lokalen System nach zu verarbeitenden Dateien durchsucht. Auf dem fernen System wird dagegen nur das Basisverzeichnis, das Sie angegeben haben, nach zu verarbeitenden Dateien durchsucht.

    • 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 dieser Eigenschaft wird durch den Wert der Eigenschaft 'transferMode' des konfigurierbaren FTP-Server-Service überschrieben, falls ein Wert festgelegt ist.

      Diese Eigenschaft ist nur gültig, wenn FTP als Protokoll für Fernübertragungen ausgewählt ist. Wenn Sie SFTP als Protokoll angegeben haben, wird die Eigenschaft Übertragungsmodus ignoriert und binäre Codierung verwendet.

    • Geben Sie unter Scan-Verzögerung an, wie viele Sekunden zwischen den Verzeichnissuchläufen gewartet werden soll. Der Standardwert beträgt 60 Sekunden. Der für diese Eigenschaft festgelegte Wert überschreibt den auf der Registerkarte Abfrage für das Abfrageintervall gesetzten Wert, wenn die Eigenschaft Fernübertragung ausgewählt ist. Der Wert dieser Eigenschaft wird durch den Wert der Eigenschaft 'scanDelay' des konfigurierbaren FTP-Server-Service überschrieben, falls ein Wert festgelegt ist.
  10. Definieren Sie auf der Registerkarte Transaktionen den Transaktionsmodus. Zwar sind alle Dateioperationen nicht transaktionsorientiert, der Transaktionsmodus an diesem Empfangsknoten entscheidet jedoch darüber, ob die verbleibenden Knoten im Nachrichtenfluss unter Synchronisationspunktsteuerung gestellt werden sollen. Wählen Sie Ja aus, wenn die Flussaktualisierungen nach Möglichkeit transaktionsorientiert behandelt werden sollen, oder wählen Sie Nein aus, wenn nicht. Der Standardwert für diese Eigenschaft lautet Nein.
  11. Optional: Legen Sie auf der Registerkarte Instanzen Werte für die Eigenschaften fest, mit denen die für einen Knoten verfügbaren zusätzlichen Instanzen (Threads) gesteuert werden. Nähere Informationen finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.

Terminals und Eigenschaften

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

Terminal Beschreibung
Fehlerterminal Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn ein Fehler auftritt, bevor eine Nachricht an das Ausgangsterminal weitergegeben wird. An dieses Terminal weitergegebene Nachrichten werden nicht ausgewertet. Dies gilt selbst dann, wenn über die Eigenschaft Auswerten angegeben wurde, dass eine Auswertung stattfinden soll.
Ausgang Das Ausgabeterminal, an das eine Nachricht weitergeleitet wird, wenn sie erfolgreich aus der Eingabedatei extrahiert wurde. Wenn keine Fehler im Eingabefluss auftreten, wird die von einer externen Ressource empfangene Nachricht immer zuerst an das Ausgabeterminal gesendet.
Datenende Das Ausgabeterminal, an das die Nachricht 'Dateiende' geleitet wird, nachdem alle Nachrichten in einer Datei verarbeitet wurden. Die Nachrichtenflusstransaktion 'Datenende' wird nur initialisiert, wenn dieses Terminal angeschlossen ist.
Catch-Terminal Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn nachgeschaltet eine Ausnahmebedingung ausgegeben und von diesem Knoten abgefangen wurde. Ausnahmen werden nur abgefangen, wenn dieses Terminal angeschlossen ist.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte O zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, 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 zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

Eigenschaften von Beschreibung:

Eigenschaft M C Standardwert Beschreibung
Knotenname Nein Nein FileInput Der Name des Knotens.
Kurzbeschreibung Nein Nein Keine Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein Keine Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt.

Eigenschaften von Grundeinstellung:

Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Eingabeverzeichnis Ja Ja Keine Der Pfad des Verzeichnisses, aus dem Eingabedateien verarbeitet werden. Das Verzeichnis muss sich in einem Dateisystem befinden, auf das der Broker Zugriff hat. Wenn kein Eingabeverzeichnis vorhanden ist, werden keine Dateien verarbeitet. Der FileInput-Knoten überprüft im durch die Eigenschaft Scan-Verzögerung festgelegten Intervall, ob das Eingabeverzeichnis vorhanden ist. Das Eingabeverzeichnis muss vorhanden sein, selbst wenn Sie Dateien über FTP oder SFTP verarbeiten.

Der FileInput-Knoten erstellt im angegebenen Eingabeverzeichnis das Unterverzeichnis mqsitransitin. Im Unterverzeichnis mqsitransitin werden die Eingabedateien während ihrer Verarbeitung gespeichert und gesperrt. Wenn eine Ausführungsgruppe, die Dateien in diesem Eingabeverzeichnis verarbeitet, entfernt wird, müssen Sie unbedingt prüfen, ob sich im Unterverzeichnis mqsitransitin teilweise oder nicht verarbeitete Dateien befinden. Verschieben Sie derartige Dateien wieder in das Eingabeverzeichnis (und entfernen Sie das UUID-Ausführungsgruppenpräfix aus den Dateinamen), damit sie von einer anderen Ausführungsgruppe verarbeitet werden können.

inputDirectory
Lokale Unterverzeichnisse einschließen Ja Ja False Gibt an, ob alle Unterverzeichnisse unter dem angegebenen Eingabeverzeichnis ebenfalls nach zu verarbeitenden Dateien durchsucht werden müssen. Wenn Sie diese Eigenschaft und die Eigenschaft Fernübertragung auswählen, wird nur das Basisverzeichnis, das Sie angegeben haben, auf dem fernen System nach Dateien durchsucht. recursiveDirectories
Dateiname oder Muster Ja Ja * Ein Dateiname oder eine Zeichenfolge mit optionalen Platzhalterzeichen (* oder ?) zur Bezeichnung der zu verarbeitenden Datei(en) aus dem Eingabeverzeichnis. filenamePattern
Dateiausschlussmuster Nein Ja Keine Eine einfache Zeichenfolge mit optionalen Platzhalterzeichen (* und ?), das Dateien angibt, die von der Verarbeitung ausgeschlossen werden sollen. excludePattern
Maßnahme bei erfolgreicher Verarbeitung Ja Nein Löschen Die Maßnamen, die der Knoten nach erfolgreicher Verarbeitung der Inhalte ergreift. Folgende Optionen sind gültig:
  • In Unterverzeichnis des Archivs verschieben
  • Zeitmarke hinzufügen und in Unterverzeichnis des Archivs verschieben
  • Löschen
 
Doppelt vorhandene Archivdatei ersetzen Ja Nein Nicht ausgewählt Über diese Eigenschaft wird gesteuert, ob der Knoten vorhandene Archivdateien, die denselben Namen wie die Eingabedatei haben, überschreibt. Sie gilt nur, wenn für Maßnahme bei erfolgreicher Verarbeitung nicht Löschen angegeben ist.  

In der folgenden Tabelle werden die Eigenschaften von 'Syntaxanalyse der Eingabenachricht' des FileInput-Knotens beschrieben:

Eigenschaft M C Standardwert Beschreibung
Nachrichtendomäne Nein Nein BLOB (Binary large object) Die Domäne für die Syntaxanalyse der Nachricht. Wenn das Feld leer ist, ist der Standardwert BLOB.
Nachrichtenmodell Nein Nein Nicht ausgewählt Der Name oder die Position des Nachrichtenmodellschemas, in dem die Nachricht definiert ist. Diese Liste wird mit allen verfügbaren Schemadateien für Nachrichtenmodelle gefüllt, die in der von Ihnen ausgewählten Nachrichtendomäne definiert sind.
Nachricht Nein Nein Nicht ausgewählt Der Name bzw. die Position eines globalen Elements, das ein gesamtes Datendokument modelliert und in der Schemadatei des Nachrichtenmodells enthalten ist. Diese Liste wird mit allen verfügbaren Nachrichten gefüllt, die in dem von Ihnen ausgewählten Nachrichtenmodell definiert sind.
Physisches Format Nein Nein Nicht ausgewählt Der Name des physischen Formats der Nachricht. Wenn Sie den MRM- oder IDOC-Parser verwenden, wählen Sie das physische Format der ankommenden Nachricht aus der Liste aus. Diese Liste enthält alle physischen Formate, die Sie für das ausgewählte Nachrichtenmodell definiert haben. Wenn Sie die Eigenschaft Nachrichtendomäne auf DataObject setzen, können Sie diese Eigenschaft auf XML oder SAP ALE IDoc setzen. Legen Sie für diese Eigenschaft SAP ALE IDoc fest, wenn ein Bitstrom aus einer externen Quelle analysiert und eine Nachrichtenbaumstruktur generiert werden muss.
ID des codierten Nachrichtenzeichensatzes Ja Nein Systemstandardwert des Brokers Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. Die Eigenschaft mqsiapplybaroverride des Befehls lautet 'messageCodedCharSetIdProperty'.
Nachrichtenverschlüsselung Ja Nein Ermitteltes Brokersystem Das Codeumsetzungsschema für Zahlen und umfangreiche Zeichen, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. Gültige Werte sind Ermitteltes Brokersystem oder ein numerischer Codierungswert. Weitere Informationen zur Codierung finden Sie unter Datenkonvertierung. Die Eigenschaft mqsiapplybaroverride des Befehls lautet 'messageEncodingProperty'.

Eigenschaften von Parser-Optionen:

Eigenschaft M C Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Durch diese Eigenschaft wird gesteuert, zu welchem Zeitpunkt eine Eingabenachricht syntaktisch analysiert wird. Gültige Werte sind:
  • Bei Bedarf
  • Sofort
  • Vollständig

Eine vollständige Beschreibung dieser Eigenschaft finden Sie unter Bedarfsgerechte Syntaxanalyse.

Baumstruktur unter Verwendung von XML-Schemadatentypen erstellen Nein Nein Nicht ausgewählt Über diese Eigenschaft wird gesteuert, ob die Datentypen der Syntaxelemente in der Nachrichtenbaumstruktur dem XML-Schema entnommen werden.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Legt fest, ob der XMLNSC-Kompaktparser für Nachrichten in der XMLNS-Domäne verwendet wird. Wenn Sie diese Eigenschaft festlegen, werden die Nachrichtendaten in Knoten, die mit dem Ausgabeterminal verbunden sind, unter XMLNSC angezeigt, wenn es sich bei einem der folgenden Elemente um XMLNS handelt:
  • MQRFH2-Eingabeheader
  • Eigenschaft 'Nachrichtendomäne' unter 'Syntaxanalyse der Eingabenachricht'
Zugriff auf gemischten Inhalt Nein Nein Nicht ausgewählt Legt fest, ob der XMLNSC-Parser für gemischten Text in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für gemischten Text erstellt. Andernfalls wird gemischter Text ignoriert, und es werden keine Elemente erstellt.
Kommentare beibehalten Nein Nein Nicht ausgewählt Legt fest, ob der XMLNSC-Parser für Kommentare in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Kommentare erstellt. Andernfalls werden Kommentare ignoriert, und es werden keine Elemente erstellt.
Verarbeitungsanweisung beibehalten Nein Nein Nicht ausgewählt Legt fest, ob der XMLNSC-Parser für Verarbeitungsanweisungen in einer Eingabenachricht Elemente in der Nachrichtenbaumstruktur erstellt. Wenn Sie das Kontrollkästchen aktivieren, werden Elemente für Verarbeitungsanweisungen erstellt. Andernfalls werden Verarbeitungsanweisungen ignoriert, und es werden keine Elemente erstellt.
Nicht transparente Elemente Nein Nein - Über diese Eigenschaft wird eine Liste von Elementen in der Eingabenachricht angegeben, die vom XMLNSC-Parser nicht transparent analysiert werden sollen. Die nicht transparente Syntaxanalyse wird nur ausgeführt, wenn keine Gültigkeitsprüfung aktiviert ist (das heißt, wenn Auswerten auf Keine gesetzt ist); Einträge, die in Nicht transparente Elemente angegeben sind, werden ignoriert, wenn die Gültigkeitsprüfung aktiviert ist.

Eigenschaft von Abfrage:

Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Abfrageintervall (Sekunden) Ja Ja 5 Das Abfrageintervall in Sekunden. waitInterval

Eigenschaften von Wiederholung:

Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Wiederholungsmechanismus Ja Nein Fehler Handhabung eines Flussfehlers durch den Knoten Folgende Optionen sind gültig:
  • Fehler
  • Kurze Wiederholungszeit
  • Kurze und lange Wiederholungszeit
 
Wiederholungsschwellenwert Ja Ja 0 Dieser Wert gibt an, wie oft die Nachrichtenflusstransaktion wiederholt werden soll, wenn die Eigenschaft Wiederholungsmechanismus auf den Wert Kurze Wiederholungszeit gesetzt ist. retryThreshold
Kurzes Wiederholungsintervall Nein Ja 0 Das Intervall in Sekunden zwischen den Wiederholungen, wenn für die Eigenschaft Wiederholungsschwellenwert ein Wert ungleich null angegeben ist. shortRetryInterval
Langes Wiederholungsintervall Nein Ja 300 Das Intervall zwischen Wiederholungen, wenn für die Eigenschaft Wiederholungsmechanismus die Option Kurze und lange Wiederholungszeit angegeben ist und der Wiederholungsschwellenwert erreicht wurde. longRetryInterval
Maßnahme bei fehlgeschlagener Datei Ja Ja In Unterverzeichnis für die Zurücksetzung verschieben Die Maßnahme, die der Knoten für die Eingabedatei ergreift, falls alle Versuche, den Dateiinhalt zu verarbeiten, fehlschlagen. Folgende Optionen sind gültig:
  • In Unterverzeichnis für die Zurücksetzung verschieben
  • Löschen
  • Zeitmarke hinzufügen und in Unterverzeichnis für Zurücksetzung verschieben
 

Eigenschaften von Datensätze und Elemente:

Eigenschaft M C Standardwert Beschreibung
Datensatzerkennung Ja Nein Gesamte Datei Mechanismus zur Identifikation von Datensätzen in der Eingabedatei. Folgende Optionen sind gültig:
  • Gesamte Datei

    Wenn Sie diese Eigenschaft auf Gesamte Datei setzen, werden Dateien mit einer Größe von mehr als 2 GB nicht unterstützt.

  • Feste Länge
  • Mit Begrenzer
  • Syntaktisch analysierte Folge
Länge Ja Nein 80 Die Länge der einzelnen Datensätze in Bytes, wenn die Datensatzerkennung Feste Länge ausgewählt ist.
Begrenzer Ja Nein DOS- oder UNIX-Linienende Die Art der Begrenzerbytes, mit denen die einzelnen Datensätze getrennt oder beendet werden, wenn die Datensatzerkennung Mit Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
  • DOS- oder UNIX-Linienende
  • Angepasster Begrenzer
Angepasster Begrenzer Nein Nein   Die hexadezimal ausgedrückten Begrenzerbytes, wenn die Datensatzerkennung Mit Begrenzer und Angepasster Begrenzer ausgewählt sind. Diese Eigenschaft ist nur obligatorisch, wenn die Eigenschaft Begrenzer auf Angepasster Begrenzer gesetzt ist.
Begrenzertyp Ja Nein Postfix Position des Begrenzers, wenn die Datensatzerkennung Mit Begrenzer ausgewählt ist. Folgende Optionen sind gültig:
  • Postfix
  • Infix
Diese Eigenschaft wird ignoriert, es sei denn, Begrenzer ist auf Angepasster Begrenzer gesetzt.
Ersten Datensatz überspringen Ja Nein FALSE Überspringen des ersten Datensatzes in der Datei. Der FileInput-Knoten liest den ersten Datensatz in der Datei, gibt den Datensatz jedoch nicht an das Ausgangsterminal weiter. Datensätze werden vom zweiten Datensatz an wie üblich weitergegeben. Verwenden Sie diese Option, wenn der erste Datensatz ein Header ist, der nicht verarbeitet werden muss. Bei Verwendung der gesamten Datei ist diese Option nicht gültig.

Eigenschaften von Auswertung:

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Nein Ja Keines Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Keines
  • Inhalt und Wert
  • Inhalt
validateMaster
Aktion bei Fehler Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Gültige Werte sind:
  • Benutzertrace
  • Lokales Fehlerprotokoll
  • Ausnahme
  • Ausnahmeliste
 

Eigenschaften von FTP:

Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Fernübertragung Nein Ja Nicht ausgewählt Diese Eigenschaft bestimmt, ob der Knoten die auf der Registerkarte FTP aufgeführten Eigenschaften für Dateiübertragungen über Fernzugriff verwendet und Dateien entweder von einem FTP- oder SFTP-Server liest. Wenn Sie diese Eigenschaft und die Eigenschaft Lokale Unterverzeichnisse einschließen auswählen, wird nur das Basisverzeichnis, das Sie angegeben haben, auf dem fernen System nach Dateien durchsucht files. fileFtp
Übertragungsprotokoll Nein Ja FTP Diese Eigenschaft gibt das Protokoll an, das für die Fernübertragung verwendet werden soll. Gültige Werte sind:
  • FTP
  • SFTP
remoteTransferType
Ferner Server und Port Nein Ja Keine Für diese Eigenschaft kann einer der folgenden Werte angegeben werden:
  • Die IP-Adresse oder der Name (und optional die Portnummer) eines fernen FTP- oder SFTP-Servers, z. B. ftp.server.com:21 oder sftp.server.com:22
  • Der Name eines konfigurierbaren Service des Typs 'FtpServer'
Bei Angabe des Namens eines konfigurierbaren Service können die übrigen Fernübertragungseigenschaften teilweise oder vollständig von dem konfigurierbaren Service überschrieben werden.
fileFtpServer
Sicherheitsidentität Nein Ja   Der Name der Benutzer-ID, die für den Zugriff auf den FTP- oder SFTP-Server verwendet wird. Diese Eigenschaft wird mit der Eigenschaft 'securityIdentity' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert. fileFtpUser
Serververzeichnis Nein Ja "." Das Verzeichnis auf dem FTP- oder SFTP-Server, aus dem Dateien übertragen werden sollen. Wird für diese Eigenschaft 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. fileFtpDirectory
Übertragungsmodus Nein Nein Binär Der FTP-Übertragungsmodus für die Übertragung von Dateidaten. Diese Eigenschaft ist nur gültig, wenn FTP als Protokoll für Fernübertragungen ausgewählt ist. Gültige Werte sind:
  • Binär
  • ASCII
Diese Eigenschaft wird mit der Eigenschaft 'transferMode' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.

Wenn Sie SFTP als Protokoll für Fernübertragungen angegeben haben, wird die Eigenschaft Übertragungsmodus ignoriert und binäre Codierung verwendet.

 
Scan-Verzögerung Nein Ja 60 Die Verzögerung in Sekunden zwischen den Suchläufen für die fernen Verzeichnisse. Diese Eigenschaft überschreibt den Wert für Abfrageintervall, wenn die Eigenschaft Fernübertragung ausgewählt ist. Diese Eigenschaft wird mit der Eigenschaft 'scanDelay' im konfigurierbaren FTP-Server-Service überschrieben, falls definiert.  

Eigenschaften von Transaktionen:

Eigenschaft M C Standardwert Beschreibung
Transaktionsmodus Nein Ja Nein Der Transaktionsmodus an diesem Empfangsknoten ist entscheidend dafür, ob die verbleibenden Knoten im Nachrichtenfluss unter Synchronisationspunktsteuerung gestellt werden. Folgende Optionen sind gültig:
  • Ja
  • Nein
Eigenschaften von Instanzen. Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.
Eigenschaft M C Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Pool zusätzlicher Instanzen Nein Ja Pool verwenden, der dem Nachrichtenfluss zugeordnet ist Der Pool, aus dem zusätzliche Instanzen bereitgestellt werden sollen.
  • Bei Auswahl von Pool verwenden, der dem Nachrichtenfluss zugeordnet ist werden zusätzliche Instanzen aus dem Nachrichtenflusspool bereitgestellt.
  • Wenn Sie Pool verwenden, der dem Knoten zugeordnet ist auswählen, werden zusätzliche Instanzen des Knotens bereitgestellt, deren Anzahl auf dem Wert basiert, der für die Eigenschaft Zusätzliche Instanzen angegeben wurde.
componentLevel
Zusätzliche Instanzen Nein Ja 0 Die Anzahl der zusätzlichen Instanzen, die der Knoten starten kann, wenn für die Eigenschaft Pool zusätzlicher Instanzen Pool verwenden, der dem Knoten zugeordnet ist angegeben wurde. additionalInstances
Die Überwachungseigenschaften des Knotens werden in der folgenden Tabelle beschrieben.
Eigenschaft O K Standard Beschreibung
Ereignisse Nein Nein None (Keinen) 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, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:17:45


ReferenzthemaReferenzthema | Version 8.0.0.1 | ac55150_