Registerkarten zur Dokumentation

FileTransfer

FileTransfer - Ausführen

---

Teilqualifizierter FileTransfer

Teilqualifizierte FileTransfers übertragen, im Gegensatz zu vollqualifizierten FileTransfers, mithilfe von Wildcard-Zeichen auch mehrere Dateien. In diesem Dokument finden Sie eine Beschreibung, wie der Filter für Quell- und Ziel-Datei anzugeben ist, abhängig von der Version des Quell- und Ziel-Agenten.

Um einen FileTransfer teilqualifiziert durchzuführen, sind ein oder mehrere Wildcard-Zeichen in der Angabe der Quell- und Ziel-Datei einzusetzen. Zusätzlich ist die Option Wildcards verwenden zu aktivieren.

Die Verwendung der Wildcard-Zeichen ist vom effektiven FileTransfer-Protokoll abhängig:

Altes FileTransfer-Protokoll

Wenn Quell- und/oder Ziel-Agent eine niedrigere Automation Engine-Version als 9.00A aufweisen, wird das alte FileTransfer-Protokoll verwendet.

Quelle

In der Quelldatei-Angabe können die Wildcard-Zeichen * und/oder ? verwendet werden. Mindestens ist jedoch ein Wildcard-Zeichen anzugeben!
"*" steht dabei für beliebige (auch kein), "?" für genau ein Zeichen. Feste Teile des Dateinamens und Wildcard-Zeichen bilden den Filter, mit dem die zu übertragenden Dateien ermittelt werden.

Wildcards werden immer von links nach rechts gelesen. Kommt der feste Teil zwischen Wildcards öfter in der Quelldatei vor, so wird der Filter ab der Position angewandt, ab welcher der Fixteil zum ersten Mal vorkommt.

Beispiel:
Quell-Dateiangabe: *a*a*.txt
Name einer Quelldatei, die dem Filter entspricht: abrahamagasse.txt

Bei z/OS dürfen die Wildcard-Zeichen "*" und "?" nur einmal und nicht als erstes Zeichen vorkommen.

In OS/390 werden Wildcardzeichen für GDS-Dateien (Generierung von Datengruppen) nicht unterstützt. Sie können jedoch ein Script-Objekt mit Wildcards mit der prep_process_filename-Scriptfunktion für die benötigten Dateien einsetzen und für jede ausgegebene Datei mithilfe der activate_uc_object-Scriptfunktion einen JOBF starten.

Ziel

In der Angabe der Zieldatei muss das Wildcard-Zeichen * genau einmal vorkommen! Dieses steht für den gesamten variablen Anteil der Quelldatei, beginnend beim ersten (? oder *) und endend beim letzten Wildcard-Zeichen (? oder *).

Beispiel:

Quelle: ?C_SERVER_*_01.TXT
Datei, die dem Filter entspricht: UC_SERVER_LOGG_01.TXT
Ziel: TEST_*_A.TXT
Name der Zieldatei: TEST_UC_SERVER_LOGG_A.TXT

Quelle: *_SERVER_*_0?.TXT
Datei, die dem Filter entspricht: UC_SERVER_LOGG_01.TXT
Ziel: TEST_*_A.TXT
Name der Zieldatei: TEST_UC_SERVER_LOGG_01_A.TXT 

Neues FileTransfer-Protokoll

Quell- und Ziel-Agent müssen mindestens die Automation Engine-Version 9.00A aufweisen.

Quelle

siehe altes FileTransfer-Protokoll

Ziel

In der Angabe der Zieldatei kann das Zeichen * beliebig oft vorkommen. Dieses repräsentiert den gesamten variablen Anteil der Quell-Angabe, beginnend beim ersten (? oder *) und endend beim letzten Wildcard-Zeichen (? oder *).

Beachten Sie, dass für jedes * im Zieldatei-Namen alle zutreffenden Zeichen vom ersten bis zum letzten Wildcardzeichen der Quelldatei eingefügt werden. Dadurch kann der gebildete Zieldateiname sehr lang werden!

Zusätzlich stehen bis zu 9 Platzhalter in der Zieldatei-Angabe zur Verfügung, die sich auf ein bestimmtes Wildcard-Zeichen (?, *) im Quelldateinamen beziehen. Diese Platzhalter setzen sich aus dem Zeichen & und den Zahlen 1 bis 9 zusammen: &1, &2, &3 ... &9.
Die Zahl gibt dabei an, die wievielte Wildcard der Quell-Angabe angesprochen wird.
Beispiel: Der Platzhalter &3 wird durch jene Zeichen des Quelldateinamens ersetzt, die durch das dritte Wildcard-Zeichen in der Quelldatei-Angabe ermittelt werden.
Sind im Filter für die Quelldatei weniger Wildcards vorhanden, als in der Ziel-Angabe angesprochen werden, so kommt es zum Fehler beim Start des FileTransfers. Jeder dieser Platzhalter kann beliebig oft in der Zieldatei-Angabe vorkommen.

Die Wildcards * und &1, &2 ... &9 besitzen somit eine unterschiedliche Funktion und können parallel verwendet werden.

Im Zieldateinamen wird das Wildcard-Zeichen "?" generell nicht unterstützt!

In der Quell und Ziel-Angabe sollten Sie mindestens so viele Wildcards verwenden, die notwendig sind, um den Dateinamen eindeutig zu identifizieren. Ansonsten kann es dazu kommen, dass versucht wird, innerhalb eines FileTransfers mehrere Zieldateien mit demselben Namen an demselben Ort anzulegen. In diesem Fall wird die Aktion durchgeführt, die Sie mit der Einstellung "Datei vorhanden" im FileTransfer definiert haben (Abbrechen, Überschreiben oder Erweitern).

Beispiel 1

Folgendes komplexeres Beispiel verdeutlicht die möglichen Kombinationen von Wildcards bei FileTransfers.

Quell-Angabe:   a?b*c?*?d*

Quell-Dateien, die dem Filter entsprechen, und deren variablen Anteile:

Ziel-Angabe: 

Ziel-Dateien werden mit folgenden Dateinamen erstellt:

Beispiel 2

In folgendem Beispiel wird das Datum des Quell-Dateinamens im Ziel-Dateinamen umgekehrt.

Quell-Angabe:

*????_*.*

Quell-Dateien, die dem Filter entsprechen:

Ziel-Angabe:

&6_&4&5&2&3&1.&7

Ziel-Dateien werden mit folgenden Dateinamen erstellt:

Siehe auch:

FileTransfer - Ablauf
Registerkarte FileTransfer