Benutzerhandbuch > Objekte > Alphabetische Auflistung > Registerkarte FileTransfer

 Registerkarte FileTransfer

Die Registerkarte FileTransfer ist eine objekttypspezifische Registerkarte, die in dieser Form nur beim Objekt "FileTransfer" zu finden ist. Sie dient der Definition von Parametern für die Dateiübertragung und von Einstellungen zur Dateibehandlung.

Objekt: FileTransfer
Objektklasse:
Ausführbares Objekt
Objekttyp (Kurzbezeichnung):
JOBF

Beschreibung

Feld/Steuerelement

Beschreibung

Von

Quelle der Dateiübertragung

Host

Wählen Sie den Namen des Agenten aus, auf dessen Host sich die zu übertragende Datei befindet. Die Angabe einer AgentenGruppe ist ebenfalls möglich.

Beachten Sie, dass der selbe Agent bzw. die selbe AgentenGruppe nicht für Quelle und Ziel verwendet werden kann!

Code

Name einer CodeTabelle, die für den Host gültig ist.

Zusätzlich zu den CodeTabellen-Objekten werden in dem Kombinationsfeld noch Optionen für die Übertragung von Unicode-Dateien angezeigt. Dabei ist auszuwählen, um welches Unicode-Format es sich handelt: 

  • <UTF 8>
  • <UCS 2BE>
  • <UCS 2LE>

Ist einer dieser Werte gesetzt, erfolgt keine Code-Umsetzung. Das Auswahlfeld Code des FileTranfer-Ziels ist daher ausgegraut.

Login

Name eines Login-Objektes.

Komprimierung

Diese Dateien werden komprimiert übertragen.

Datei

Geben Sie den Namen der Quelldatei unter Verwendung von Verzeichnis, Ordner oder Kennung ein.

Bei teilqualifzierten FileTransfers ist statt einer vollständigen Dateiangabe ein Filter zu verwenden, der sich aus Wildcard-Zeichen und fixen Teilen des Dateinamens zusammensetzt.

VMS

Beachten Sie, dass logische Namen vom VMS-Agenten nicht aufgelöst werden! Das Verzeichnis und der Dateiname sind daher immer direkt anzugeben. Andernfalls kommt es zu einem Fehler mit der Meldung, dass die Datei nicht gefunden werden kann.

 

z/OS

Die Angabe von z/OS-Dateien hängt vom verwendeten Dateisystem ab (USS oder Host). Beispiel:

USS-Dateisystem (absolute Pfadangabe): /dir1/dir2/datei
USS-Dateisystem (relative Pfadangabe): ./dir1/dir2/datei
Host-Dateisystem: FLQN.DATASET.NAME

UNIX

Für die Bedingungen des FileTransfers unter UNIX-Agenten finden Sie genaue Angaben in dem Abschnitt UNIX-Agent.

Datei-Attribute

Zusätzliche Angabe von Datei-Attributen

Beachten Sie bitte die plattformspezifischen Besonderheiten.

Original-Datei-Attribute beibehalten

Übernahme der Dateiattribute der Quelldatei(en) für die Zieldatei(en).

Dies ist jedoch nur dann möglich, wenn:

  • Die Quell und Ziel-Plattform übereinstimmen
  • und das neue FileTransfer-Protokoll zum Einsatz kommt (Quell- und Ziel-Agent besitzen Automation Engine-Version 9.00A oder höher).

Andernfalls wird diese Option ignoriert.

Bei BS2000, OS/400 und z/OS können die Originalattribute nicht durch zusätzliche Angaben im FileTransfer-Objekt (Ziel) überschrieben werden. Sind dennoch Attribute eingetragen, schlägt der FileTransfer mit einer Fehlermeldung des Agenten fehl.

Es wird empfohlen, diese Einstellung zu aktivieren. Werden die Attribute bei der Übertragung von Textdateien zwischen zwei OS/400-Rechnern nicht mitgesendet bzw. geändert, so kann die Zieldatei fehlerhaft werden.

Wildcards verwenden

Teilqualifizierte FileTransfers.
Wählen Sie dieses Kontrollkästchen, um einen teilqualifizierten FileTransfer durchzuführen.

Unterverzeichnisse einbeziehen

Teilqualifizierte FileTransfers
Wählen Sie dieses Kontrollkästchen, um auch Dateien in Unterverzeichnissen in einen teilqualifizierten FileTransfer einzubeziehen. Nur verfügbar, wenn die beiden beteiligten Plattformen dies auch unterstützen und die Option Wildcards verwenden ausgewählt ist.

Administratoren können den Parameter WorkDirMatch= in den INI-Dateien des UNIX-Agenten benutzen, um festzulegen, ob Unterverzeichnisse in der Dateisuche einbezogen werden sollen.

Übertrage gesamte Ordnerstruktur

Für teilqualifizierte FileTransfers

Standardmäßig werden beim Übertragen der Unterzeichnisse leere Ordner nicht berücksichtigt. Aktivieren Sie diese Option, wenn auch leere Verzeichnisse übertragen werden sollen.

Diese Einstellung kann nur gesetzt werden, wenn die Option Unterverzeichnisse einbeziehen aktiviert ist.

Max. parallel laufende Transfers

Teilqualifizierte FileTransfers
Stellen Sie hier die Anzahl von Dateien ein, die bei einem teilqualifizierten FileTransfer parallel übertragen werden sollen. Je höher die Anzahl, umso mehr werden die beteiligten Rechner belastet. Nur verfügbar, wenn "Wildcards verwenden" ausgewählt ist.

Diese Einstellung ist nur für das alte FileTransfer-Protokoll relevant. Dies wird dann angewendet, wenn mindestens einer der Agenten die Automation Engine-Version 8.00A oder niedriger aufweist. Besitzen beide Agenten Version 9.00A oder höher, wird die Einstellung nicht ausgewertet. 

Beim ersten Fehler abbrechen

Für teilqualifizierte FileTransfers

Aktivieren Sie dieses Kontrollkästchen, wenn sich der FileTransfer beim ersten Fehler beenden soll. Noch nicht übertragene Dateien werden dabei nicht beachtet. Ist diese Einstellung nicht gesetzt, wird bei der nächsten Datei fortgesetzt.

FileTransfers, die auf Grund dieser Option abgebrochen werden, erhalten den Status ENDED_NOT_OK.

Die Option wird nur beachtet, wenn das neue FileTransfer-Protokoll zum Einsatz kommt (Quell- und Zielagent besitzen AE-Version 9.00A oder höher). Beim alten Protokoll wird der FileTransfer immer fortgesetzt, auch wenn die Übertragung einer bestimmten Datei scheitert.

Quelle löschen

Klicken Sie das Kontrollkästchen an, wenn die zu übertragende Datei nach dem FileTransfer gelöscht werden soll.

Beachten Sie, dass unter UNIX besondere Rechtefür das Löschen der Datei benötigt werden!

Der FileTransfer endet auch dann mit dem Status ENDED_OK, wenn alle Dateien erfolgreich übertragen wurden, aber es aus einem Grund nicht möglich war, die Quelldateien zu löschen.

Formate

 

Text

Aktivieren Sie dieses Optionsfeld, wenn die zu übertragende Datei eine Textdatei ist.

Binär

Die zu übertragende Datei ist eine Binärdatei.

Wird das Binärformat gewählt, kann bei der Übertragung von Textdateien Zeit gespart werden. Die Textdatei wird jedoch in diesem Fall nicht verändert (Formatierungen wie zum Beispiel: Zeilenumbrüche).

Nach

Ziel der Dateiübertragung

Host

Wählen Sie den Namen des Agenten aus, auf dessen Host sich die zu übertragende Datei befindet. Die Angabe einer AgentenGruppe ist ebenfalls möglich.

Beachten Sie, dass der selbe Agent bzw. die selbe AgentenGruppe nicht für Quelle und Ziel verwendet werden kann!

Code

Ziel der Dateiübertragung
Aktivieren Sie jene CodeTabelle aus dem Listenfeld, die für den Zielhost gültig ist.

Login

Quelle der Dateiübertragung, Name eines Login-Objekts.

Datei

Tragen Sie den Ort (Verzeichnis, Ordner oder Kennung) und den Namen der Zieldatei ein. Sie haben somit auch die Möglichkeit, eine Umbenennung vorzunehmen.

Im Ziel-Dateinamen kann folgende Variable eingefügt werden: &<FT_SRC_HOST>. Der FileTransfer ersetzt sie durch den Namen des Rechners, von dem die Datei stammt.

Beispiel: C:\temp\&<FT_SRC_HOST>_test*.txt

Bei teilqualifzierten FileTransfers ist statt einer vollständigen Dateiangabe ein Filter zu verwenden, der sich aus Wildcard-Zeichen und fixen Teilen des Dateinamens zusammensetzt. 

Datei-Attribute

Zusätzliche Angabe von Datei-Attributen

Beachten Sie bitte die plattformspezifischen Besonderheiten.

Datei vorhanden

 

Abbruch

Option, die zu einem Abbruch des FileTransfers führt, wenn die Datei im Zielsystem bereits vorhanden ist.

Überschreiben

Option, die zum Überschreiben der Datei führt, wenn diese im Zielsystem bereits vorhanden ist.

Erweitern

Die übertragene Datei wird an eine im Zielsystem bereits existierende Datei angehängt.

Beachten Sie bitte die plattformspezifischen Besonderheiten.

Anmerkungen

Die in dieser Registerkarte vorgenommenen Einstellungen können zur Laufzeit gelesen und verändert werden. Dabei wird mit Script-Sprachmitteln auf die Attribute dieses Objektes zugegriffen. Ist das Kontrollkästchen "Attribut-Dialog" in der Registerkarte "Attribute" ausgewählt, können die Attribute zunächst durch den Benutzer beeinflusst werden. Der Zugriff auf die Attribute im Script erfolgt erst danach.

Plattformspezifische Besonderheiten

Für das Ziel des FileTransfers können zusätzlich zum Dateinamen Dateiattribute angegeben werden:

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH