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.

FTEInput-Knoten

Über den FTEInput-Knoten können mithilfe von WebSphere MQ File Transfer Edition Dateien empfangen werden.

Dieses Thema ist in folgende Abschnitte eingeteilt:

Zweck

Mithilfe des FTEInput-Knotens können Sie die WebSphere Message Broker Version 8.0-Unterstützung für die Dateiverarbeitung durch die Integration mit WebSphere MQ File Transfer Edition erweitern. WebSphere MQ File Transfer Edition ist ein verwaltetes Dateiübertragungsprodukt, das WebSphere MQ als Transportmethode verwendet.

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

Symbol für den FTEInput-Knoten

Verwendung dieses Knotens in einem Nachrichtenfluss

Der FTEInput-Knoten kann in jedem Nachrichtenfluss verwendet werden, in dem Dateien aus einem WebSphere MQ File Transfer Edition-Netz akzeptiert werden sollen. 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 FTEInput-Knotenterminals beschrieben .

Terminal Beschreibung
Fehlerterminal (Failure) 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.
Datenendterminal 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 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 FTEInput-Knoten eine Nachricht weitergibt, werden die Informationen zu der Nachricht in den Nachrichtenbaumstrukturen 'LocalEnvironment.FTE' und 'LocalEnvironment.FTE.Transfer' gespeichert. Wenn die Eingabedatei leer ist, wird eine leere Nachricht verbreitet (und vorausgesetzt, dass die Datei gültig ist). Wenn Sie in der Eigenschaft Dateinamensfilter ein Dateinamensmuster mit Platzhalterzeichen angeben, kopiert der FTEInput-Knoten die Zeichen des Dateinamens, die den Platzhalterzeichen entsprechen, sowie alle dazwischen liegenden Zeichen in die Nachrichtenbaumstruktur 'LocalEnvironment.Wildcard.WildcardMatch'. Weitere Informationen finden Sie im Abschnitt Variablen der lokalen Umgebung mit Dateiknoten verwenden.

Eigenschaften Beschreibung

Eigenschaft O K Standardwert Beschreibung
Knotenname Nein Nein FTEInput 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
Verzeichnisfilter Nein Ja Ohne Das WebSphere MQ File Transfer Edition-Verzeichnis, aus dem Eingabedateien verarbeitet werden. inputDirectory
Dateinamensfilter Ja Ja * Ein Dateiname oder eine Zeichenfolge mit optionalen Platzhalterzeichen (* oder ?) zur Bezeichnung der zu verarbeitenden Datei(en) aus dem Eingabeverzeichnis. filenamePattern
Maßnahme bei erfolgreicher Verarbeitung Ja Nein Keine Aktion Die Maßnamen, die der Knoten nach erfolgreicher Verarbeitung der Inhalte ergreift. Folgende Optionen sind gültig:
  • Keine Aktion
  • Löschen
  • Zeitmarke hinzufügen
 

Eigenschaften für die Syntaxanalyse der Eingabenachricht

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Nachrichtendomäne Nein Nein Ohne Die Domäne für die Syntaxanalyse der ankommenden Nachricht.  
Nachrichtengruppe Nein Nein Ohne Der Name oder die ID des Nachrichtensatzes, in dem die eingehende Nachricht definiert ist.

Wenn Sie diese Eigenschaft festlegen und die Projektabhängigkeiten anschließend aktualisieren, um diesen Nachrichtensatzverweis zu entfernen, wird eine Warnung ausgegeben. Aktualisieren Sie entweder die Eigenschaft Nachrichtensatz, oder stellen Sie den Verweis auf dieses Nachrichtensatzprojekt wieder her.

 
Nachrichtenart Nein Nein Ohne Der Name der eingehenden Nachricht.  
Nachrichtenformat Nein Nein Ohne Der Name des physischen Formats der eingehenden Nachricht.  
ID des codierten Nachrichtenzeichensatzes Ja Ja Systemstandardwert des Brokers Die ID des codierten Zeichensatzes, anhand dessen die Bytes der gerade gelesenen Datei interpretiert werden. messageCodedCharSetIdProperty
Nachrichtenverschlüsselung Ja Ja Ermitteltes Brokersystem Das Codeumsetzungsschema für Zahlen, 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. messageEncodingProperty

Eigenschaften für Parser-Optionen

Eigenschaft O K Standardwert Beschreibung
Zeitpunkt für Syntaxanalyse Nein Nein Bei Bedarf Gibt an, wann 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 Gibt an, ob die Datentypen der Syntaxelemente in der Nachrichtenbaumstruktur dem XML-Schema entnommen wurden.
XMLNSC-Kompaktparser für XMLNS-Domäne verwenden Nein Nein Nicht ausgewählt Gibt an, ob für Nachrichten in der XMLNS-Domäne der XMLNSC-Kompaktparser 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 Gibt an, 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 Gibt an, 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 Gibt an, 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 Leer Gibt eine Liste mit Elementen in der Eingabenachricht an, die vom XMLNSC-Parser auf nicht transparente Weise 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.

Eigenschaften für Wiederholen

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Wiederholungsmechanismus Ja Nein Failure Handhabung eines Flussfehlers durch den Knoten Folgende Optionen sind gültig:
  • Failure
  • 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 (Sekunden) Nein Ja 0 Das Intervall in Sekunden zwischen den einzelnen Wiederholungen, wenn für die Eigenschaft Wiederholungsschwellenwert ein Wert ungleich null angegeben ist. shortRetryInterval
Langes Wiederholungsintervall (Sekunden) Nein Ja 300 Das Intervall zwischen den 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 Keine Aktion Die Maßnahme, die der Knoten für die Eingabedatei ergreift, falls alle Versuche, den Dateiinhalt zu verarbeiten, fehlschlagen. Folgende Optionen sind gültig:
  • Keine Aktion
  • Löschen
  • Zeitmarke hinzufügen
 

Eigenschaften Datensätze und Elemente

Eigenschaft O K Standardwert Beschreibung
Datensatzerkennung Ja Nein Gesamte Datei Mechanismus zur Identifikation von Datensätzen in der Eingabedatei. Folgende Optionen sind gültig:
  • Gesamte Datei
  • 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 Ohne 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.

Eigenschaften Auswertung

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Auswertungseigenschaften.

Eigenschaft O K Standardwert Beschreibung Eigenschaft des Befehls mqsiapplybaroverride
Auswertung Nein Ja Ohne Durch diese Eigenschaft wird gesteuert, ob eine Auswertung stattfindet. Gültige Werte sind:
  • Ohne
  • Inhalt und Wert
  • Inhalt
validateMaster
Fehlerbehebungsmaßnahme Nein Nein Ausnahme Durch diese Eigenschaft wird gesteuert, was beim Fehlschlagen der Auswertung geschieht. Gültige Werte sind:
  • Benutzertrace
  • Lokales Fehlerprotokoll
  • Ausnahme
  • Ausnahmeliste
 

Eigenschaften für Transaktionen

Eigenschaft O K Standardwert Beschreibung
Transaktionsmodus Nein Nein Nein Der Transaktionsmodus auf diesem Empfangsknoten ist entscheidend dafür, ob die übrigen Knoten in dem Fluss unter Verwendung eines Synchronisationspunktes ausgeführt werden. Folgende Optionen sind gültig:
  • Ja
  • Nein

Eigenschaften von Instanzen.

Eine umfassende Beschreibung dieser Eigenschaften finden Sie unter Konfigurierbare Nachrichtenflusseigenschaften.

Eigenschaft O K 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 beschafft werden.
  • 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 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:40


ReferenzthemaReferenzthema | Version 8.0.0.5 | bc34034_