|
account
|
|
|
[optional]
|
Abrechnungsinformation
Optionale Kennung zur Anmeldung an einem (FTP) Server.
Die Account-information wird normalerweise zusätzlich zu der üblichen Autentifizierung (z.B. durch User-ID und Passwort)
verwendet und ist vom Server-Administrator zu konfigurieren.
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
alternative_account
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→account
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
Abrechnungsinformation
Optionale Kennung zur Anmeldung an einem (FTP) Server.
Die Account-information wird normalerweise zusätzlich zu der üblichen Autentifizierung (z.B. durch User-ID und Passwort)
verwendet und ist vom Server-Administrator zu konfigurieren.
|
|
alternative_host
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→host
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
| DataType: SOSOptionHostName |
| Default-Value:
---
|
|
|
alternative_passive_mode
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→passive_mode
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
|
|
alternative_password
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→password
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
|
|
alternative_port
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→port
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
| DataType: SOSOptionPortNumber |
| Default-Value:
---
|
|
|
alternative_remote_dir
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→remote_dir
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
|
|
alternative_transfer_mode
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→transfer_mode
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
|
|
alternative_user
|
|
|
[optional]
|
Alternativer Parameter für den primären Parameter
→user
.
Die alternativen Parameter werden nur verwendet, wenn die Verbindung zum (FTP/SFTP) Server
fehlschlägt, z.B. der Server nicht verfügbar ist,
die Zugangsdaten ungültig sind etc.
|
|
append_files
|
|
|
[optional]
|
Der Parameter bestimmt, ob der Inhalt einer Quelldatei an die Zieldatei
angehängt wird, falls die Zieldatei existiert.
Der Parameter
→overwrite_files
wird nicht beachtet,
falls
→append_files
den Wert
true
aufweist.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
atomic_prefix
|
|
|
[optional]
|
Der Parameter bestimmt, ob Zieldateien zunächst mit einem prefix, z.B. "~", erzeugt
und nach vollständiger Übertragung in den endgültigen Zieldateinamen umbenannt werden,
damit die Dateien atomar im Verzeichnis erscheinen.
Als Wert des Parameters wird eine Zeichenfolge (oder ein Zeichen) für das temporäre prefix angegeben werden.
Diese Einstellung wird empfohlen, falls Zielverzeichnisse von einer Applikation oder
mit einem JobScheduler für Dateiaufträge überwacht werden.
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
atomic_suffix
|
|
|
[optional]
|
Der Parameter bestimmt, ob Zieldateien zunächst mit einem Suffix, z.B. "~", erzeugt
und nach vollständiger Übertragung in den Zieldateinamen umbenannt werden,
damit die Dateien atomar im Verzeichnis erscheinen.
Als Wert des Parameters kann das temporäre Suffix angegeben werden.
Diese Einstellung wird empfohlen, falls Zielverzeichnisse von einer Applikation oder
mit einem Job Scheduler für Dateiaufträge überwacht werden.
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
banner_footer
|
Name der Template-Datei für Protokoll-Ende
|
|
[optional]
|
Name der Template-Datei für Protokoll-Ende
Das Programm nimmt Ausgaben nach stdout bzw. in eine mit dem Parameter
→log_filename
angegebene Datei vor und kann
zur Strukturierung dieser Ausgaben eine Musterdatei verwenden.
Die Ausgaben sind in die Gruppen Header, Dateiliste und Footer gegliedert.
Mit diesem Parameter wird eine Musterdatei für den Footer zugewiesen.
Musterdateien können interne Variablen und Parameter als Platzhalter
in der Form %{platzhalter} verwenden, das Standard-Muster für Footer hat diesen Inhalt:
*************************************************************************
execution status = %{status}
successful transfers = %{successful_transfers}
failed transfers = %{failed_transfers}
last error = %{last_error}
*************************************************************************
| DataType: SOSOptionInFileName |
| Default-Value:
---
|
|
|
banner_header
|
Name der Datei mit einem Protokoll-Template
|
|
[optional]
|
Name der Datei mit einem Protokoll-Template
Das Programm nimmt Ausgaben nach stdout bzw. in eine mit dem Parameter
→log_filename
angegebene Datei vor und kann
zur Strukturierung dieser Ausgaben eine Musterdatei verwenden.
Die Ausgaben sind in die Gruppen Header, Dateiliste und Footer gegliedert.
Mit diesem Parameter wird eine Musterdatei für den Header zugewiesen.
Musterdateien können interne Variablen und Parameter als Platzhalter
in der Form %{platzhalter} verwenden, das Standard-Muster für Header hat diesen Inhalt:
*************************************************************************
* *
* SOSFTP - Managed File Transfer Utility *
* -------------------------------------- *
* *
*************************************************************************
version = %{version}
date = %{date} %{time}
operation = %{operation}
protocol = %{protocol}
file specification = %{file_spec}
file path = %{file_path}
source host = %{localhost} (%{local_host_ip})
local directory = %{local_dir}
jump host = %{jump_host}
target host = %{host} (%{host_ip})
target directory = %{remote_dir}
pid = %{current_pid}
ppid = %{ppid}
*************************************************************************
| DataType: SOSOptionInFileName |
| Default-Value:
---
|
|
|
check_interval
|
|
|
[optional]
|
Der Parameter bestimmt das Wiederholungsintervall in Sekunden zwischen zwei Versuchen
eine Datei zu übertragen, wenn mit dem Parameter
→check_retry
eine wiederholte Übertragung vereinbart wurde.
| DataType: SOSOptionInteger |
| Default-Value: 60 |
|
|
check_retry
|
|
|
[optional]
|
Der Parameter bestimmt, ob eine Datei mehrfach übertragen werden soll,
um zu prüfen, ob die Datei beim Start der Verarbeitung vollständig
am FTP/SFTP Server vorhanden war. Dies ist z.B. für Unix Dateisysteme relevant,
bei denen Dateien gleichzeitig gelesen und geschrieben werden können.
Der Parameter veranlasst den Vergleich der Dateigrößen für die aktuelle und die vorhergehende Übertragung
und wiederholt bis zu der mit diesem Parameter angebebenen Anzahl die Wiederholungsversuche
eine Datei zu übertragen. Stimmen die Dateigrößen aus zwei aufeinanderfolgenden Übertragungen überein,
dann gilt die Datei als korrekt übertragen.
Mit dem Parameter
→check_interval
kann das Intervall zwischen
zwei Wiederholungsversuchen eine Datei zu übertragen eingestellt werden.
| DataType: SOSOptionInteger |
| Default-Value: 0 |
|
|
check_size
|
|
|
[optional]
|
Der Parameter bestimmt, ob nach dem Transfer die Größen der übertragenen Datei
und der Anzahl übertragener Byte geprüft werden und im Fall fehlender Übereinstimmung
ein Fehler ausgelöst wird.
| DataType: SOSOptionBoolean |
| Default-Value: true |
|
|
classpath_base
|
|
|
[optional]
|
Der Parameter wird bei der Installation des Programms auf einem Remote Server
verwendet in Zusammenhang mit dem Parameter
→operation
=install.
Der Parameter bestimmt den Pfad des Java Runtime Environments (JRE)
am Remote Server und wird eingesetzt falls auf diesem System
kein JRE im Pfad verfügbar ist.
Der Pfad des angegebenen JRE wird in das Start Script am Remote Server übernommen
( sosftp.cmd bzw. sosftp.sh).
| DataType: SOSOptionFolderName |
| Default-Value:
---
|
|
|
compress_files
|
|
|
[optional]
|
Mit diesem Parameter wird festgelegt, ob der Inhalt der Dateien
"gezippt", also
komprimiert wird.
Der Parameter wird beim
Senden
von Daten ausgewertet und falls auf "true" gesetzt,
werden die zu sendenden Datei(en) vor dem Senden komprimiert mit einem
Zip-kompatiblen
Verfahren.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
compressed_file_extension
|
Dateinamenendung für komprimierte Dateien
|
|
[optional]
|
Dateinamenendung für komprimierte Dateien
Der Parameter bestimmt die Endung des Dateinamens, falls eine
Komprimierung
mit dem Parameter
→compress_files
durchgeführt wird.
Die Endung wird an an eine evtl. bereits vorhandene Dateinamensendung angehängt.
| DataType: SOSOptionString |
| Default-Value: .gz |
|
|
current_pid
|
|
|
[optional]
|
Der Parameter wird unter Unix verwendet und - abweichend von anderen Parametern -
i.d.R. bereits im Start Script sosftp.sh eingesetzt.
Als Wert wird die Umgebungsvariable $$ übergeben, die
die die aktuelle Prozessnummer (PID) enthält.
Die Prozessnummer wird beim Schreiben einer Historiendatei für jeden Transfer
protokolliert (siehe Parameter
→history
),
um nachvollziehbar zu halten, von welchem Prozess Dateien übertragen wurden.
| DataType: SOSOptionProcessID |
| Default-Value:
---
|
|
|
file_path
|
|
|
[optional]
|
Der Parameter wird alternativ zum Parameter
→file_spec
verwendet und
benennt eine Datei für den Transfer.
- Beim Empfang von Dateien gilt:
Name und Pfad der Datei am FTP/SFTP Server, die übertragen wird.
Der Dateiname muss als Bestandteil den Pfad am FTP/SFTP Server enthalten.
Die Datei wird unter ihrem Namen in dem mit dem Parameter
→local_dir
angegebenen Verzeichnis abgelegt.
Folgende Parameter werden mit der Angabe dieses Parameters
ignoriert:
→file_spec
und
→remote_dir
.
- Für das Senden von Dateien gilt:
Der Parameter nimmt den absoluten Namen und Pfad einer Datei auf, die übertragen wird.
Der Dateipfad muss absolut angegeben sein.
Die Datei wird unter ihrem Namen in dem Verzeichnis am FTP/SFTP Server abgelegt,
das mit dem Parameter
→remote_dir
angegeben ist.
Folgende Parameter werden mit der Angabe dieses Parameters
ignoriert:
→file_spec
und
→local_dir
.
| DataType: SOSOptionFileName |
| Default-Value:
---
|
|
|
file_spec
|
file_spec
|
|
[optional]
|
file_spec
Der Parameter erwartet einen regulären Ausdruck, um eine oder mehrere
Dateien aus einem lokalen Verzeichnis oder einem Verzeichnis am FTP/SFTP Server zu selektieren,
(in Abhängigkeit vom Parameter
→operation
, der mit den Werten send
und receive die Richtung des Transfers bestimmt)
die übertragen werden sollen.
Für die Operationen send und receive muss entweder dieser Parameter
oder der Parameter
→file_path
bzw. eine Liste von Dateinamen als zusätzliche
Parameter angegeben sein.
| DataType: SOSOptionRegExp |
| Default-Value: .* |
|
|
file_spec2
|
|
|
[optional]
|
In Ergänzung zum Parameter
→file_spec
können Parameter
für weitere Dateigruppen in dieser Form angegeben werden:
file_spec2, file_spec3, ..., file_spec9
Diese Parameter spezifizieren jeweils eine Dateigruppe, für die individuelle Transfereinstellungen gelten.
Bis zu 9 Dateigruppen lassen sich auf diese Weise angeben:
-file_spec=.*\.gif$ -local_dir=/tmp/1 -remote_dir=/tmp/1
-file_spec2=.*\.exe$::param_set_2 -param_set_2="transfer_mode=binary::remote_dir=/tmp/2::local_dir=/tmp/2"
Dabei wird durch :: getrennt dem regulären Ausdruck, der die Dateigruppe spezifiziert,
der Name einer Parametergruppe zugewiesen. Dieser Name ist frei wählbar, er darf
nur die Zeichen 0-9, a-z sowie _ enthalten.
Der Name der Parametergruppe wird als selbstständiger Parameter an der Kommandozeile aufgeführt.
Als Wertzuweisung der Parametergruppe werden die für diese Gruppe geltenden abweichenden Parameter spezifiziert.
Dazu werden jeweils im Format name=wert::name2=wert2 ... die Namen und Werte
derjenigen Parameter aufgeführt, die speziell für diese Gruppe gelten.
Im obigen Beispiel werden für alle mit der Endung .gif versehenen Dateien vom lokalen
Verzeichnis /tmp/1 in das gleichnamige Verzeichnis am Zielsystem übertragen.
Für Dateien mit der Endung .exe wird eine Gruppe param_set_2 spezifiziert,
die abweichende Transferparameter aufweist, z.B. binäre Übertragung und andere Quell- bzw. Zielverzeichnisse.
Bitte beachten Sie, dass in Parametergruppen keine Parameter zur Steuerung des Verbindungsaufbaus
angegeben werden können, d.h. die Dateien werden immer zwischen denselben Systemen übertragen,
allerdings kann die Transferrichtung wechseln, z.B. durch Angabe des Parameters
→operation
für eine Dateigruppe.
| DataType: SOSOptionRegExp |
| Default-Value:
---
|
|
|
force_files
|
|
|
[optional]
|
Der Parameter bestimmt, ob ein Fehler ausgelöst wird, wenn keine Dateien
für die Übertragung gefunden werden.
Der Umfang der zu übertragenen Dateien wird mit den Parametern
→file_spec
und
→file_path
bestimmt und ggf. durch den Parameter
→overwrite_files
eingeschränkt, falls dieser den Wert
false
aufweist.
| DataType: SOSOptionBoolean |
| Default-Value: true |
|
|
history
|
|
|
[optional]
|
Der Parameter benennt den Pfad und Namen einer Historiendatei im CSV Format.
Für jede transferierte Datei wird ein Eintrag geschrieben.
Die Historiendatei enthält folgende Spalten:
- guid
Ein eindeutige Identifikation des Historieneintrags. Sie wird zur Prüfung von Dubletten
in Kombination mit dem Job Scheduler für Managed File Transfer verwendet.
- mandator
Die Bezeichnung eines Mandanten, für den der File Transfer durchgeführt wurde.
- transfer_timestamp
Der Zeitpunkt des File Transfers.
- pid
Die Prozessnummer des aktuellen Prozesses, der den File Transfer durchführt,
siehe Parameter
→current_pid
.
- ppid
Die Prozessnummer des Vaterprozesses des aktuellen Prozesses, der den File Transfer durchführt.
siehe den entsprechenden Parameter.
- operation
Eine der Operationen send oder receive, siehe den entsprechenden Parameter.
- localhost
Der Name des Hosts, auf dem dieses Programm ausgeführt wird.
- localhost_ip
Die IP-Adresse des Hosts, auf dem dieses Programm ausgeführt wird.
- local_user
Der Name des lokalen Benutzer-Accounts, für den dieses Programm ausgeführt wird.
- remote_host
Der Name des Hosts zu/von dem ein Transfer ausgeführt wird,
siehe Parameter
→host
.
- remote_host_ip
Die IP-Adresse des Hosts zu/von dem ein Transfer ausgeführt wird,
siehe Parameter
→host
.
- remote_user
Der Name des Benutzer-Accounts auf dem Remote Host,
siehe Parameter
→user
.
- protocol
Als Protokoll wird ftp, sftp oder ftps verwendet,
siehe den entsprechenden Parameter.
- port
Der Port am Remote Host, siehe den entsprechenden Parameter.
- local_dir
Das lokale Verzeichnis zu/von dem eine Datei transferiert wurde, siehe den entsprechenden Parameter.
- remote_dir
Das Verzeichnis am Remote Host zu/von dem eine Datei transferiert wurde, siehe den entsprechenden Parameter.
- local_filename
Für die Operation send ist dies der Original-Dateiname am lokalen System.
Für die Operation receive ist dies der resultierende Dateiname am lokalen System,
nachdem ggf. eine Ersetzung des Dateinamens erfolgt ist, siehe Parameter
→replacing
.
- remote_filename
Für die Operation send ist dies der resultierende Dateiname am Remote Host,
nachdem ggf. eine Ersetzung des Dateinamens erfolgt ist, siehe Parameter
→replacing
.
Für die Operation receive ist dies der Original-Dateiname am Remote Host.
- file_size
Die Größe der übertragenen Date in Bytes.
- md5
Der Wert des MD5 Hash, der aus der übertragenen Datei gewonnen wurde.
- status
Als Status kann success oder error aufgeführt sein.
- last_error_message
Falls ein Fehler aufgetreten ist, dann wird die letzte Fehlermeldung ausgegeben.
- log_filename
Der Name der Protokolldatei, siehe den entsprechenden Paramter.
| DataType: SOSOptionOutFileName |
| Default-Value:
---
|
|
|
history_repeat
|
|
|
[optional]
|
Der Parameter wird verwendet, um das gleichzeitige Schreiben mehrerer
Instanzen dieses Programms in die Historiendatei zu synchronisieren.
Der Parameter bestimmt die maximale Anzahl der Wiederholungsintervall beim Schreiben
in die Historiendatei, falls die Datei von einer anderen Instanz dieses
Programms gesperrt ist.
| DataType: SOSOptionInteger |
| Default-Value: 3 |
|
|
history_repeat_interval
|
|
|
[optional]
|
Der Parameter wird verwendet, um das gleichzeitige Schreiben mehrerer
Instanzen dieses Programms in die Historiendatei zu synchronisieren.
Der Parameter bestimmt das Zeitintervall in Sekunden zwischen zwei Wiederholungsintervall beim Schreiben
in die Historiendatei, falls die Datei von einer anderen Instanz dieses
Programms gesperrt ist, siehe Parameter
→history_repeat
.
| DataType: SOSOptionInteger |
| Default-Value: 1 |
|
|
host
|
Host-Name
|
|
[required]
|
Host-Name
Der Parameter benennt den Hostnamen (z.B. wilma.sos) oder die IP-Adresse (z.B. IPv4 192.168.0.1) des (FTP, SFTP, SSH, etc.) Servers,
zu dem eine Verbindung hergestellt werden soll.
| DataType: SOSOptionHostName |
| Default-Value:
---
|
|
|
http_proxy_host
|
|
|
[optional]
|
Der Wert des Parameters ist der Hostname oder die IP-Adresse eines Proxies,
über den die Verbindung zum SSH Server via SSL/TLS hergestellt wird.
Die Verwendung von Proxies ist optional und nur wirksam mit dem
Parameter
→protocol=ftps
.
|
|
http_proxy_port
|
|
|
[optional]
|
Der Wert des Parameters ist der Port des Proxies, über den eine Verbindung
zum SSH Server via SSL/TLS hergestellt wird,
siehe Parameter
→http_proxy_host
.
|
|
jump_command
|
|
|
[optional]
|
Der Parameter beinhaltet das Kommando, das am SSH Server ausgeführt wird.
Mehrere Kommandos können durch die im Parameter
→jump_command_delimiter
angegebene Zeichenfolge getrennt angegeben werden.
| DataType: SOSOptionCommandString |
| Default-Value:
---
|
|
|
jump_command_delimiter
|
|
|
[required]
|
Alternativ können mehrere getrennt auszuführende Kommandos durch die mit diesem Parameter
bestimmte Zeichenfolge getrennt im Wert des Parameters
→jump_command
angegeben werden.
Getrennt auszuführende Kommandos werden in separaten SSH Sessions ausgeführt.
| DataType: SOSOptionString |
| Default-Value: %% |
|
|
jump_command_script
|
|
|
[optional]
|
| DataType: SOSOptionCommandScript |
| Default-Value:
---
|
|
|
jump_command_script_file
|
|
|
[optional]
|
| DataType: SOSOptionCommandScriptFile |
| Default-Value:
---
|
|
|
jump_host
|
|
|
[optional]
|
Bei Verwendung eines
→jump_host
werden Dateien zunächst auf diesen
Server transferiert und anschließend an das Zielsystem. Dabei können unterschiedliche
Protokolle (FTP/SFTP) für die beiden Transferoperationen verwendet werden.
Host oder IP-Adresse des
→jump_host
, von dem bzw. zu dem Dateien zunächst übertragen werden.
|
|
jump_ignore_error
|
|
|
[optional]
|
Wird der Wert true angegeben, dann werden Fehler bei Ausführung von
Kommandos im SSH Server ignoriert, andernfalls werden sie als Fehler gemeldet.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
jump_ignore_signal
|
|
|
[optional]
|
Wird der Wert true angegeben, dann werden unter Unix
Signale ignoriert, die zur Beendigung des am SSH Server ausgeführten Kommandos führen,
z.B. falls ein Kommando mit kill beendet wurde.
Per Voreinstellung wird das Beenden von Kommandos durch Signale als
Fehler gemeldet.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
jump_ignore_stderr
|
|
|
[optional]
|
Der Job prüft das Vorhandensein von Ausgaben nach stderr des am SSH Server ausgeführten Kommandos
und interpretiert dies als Fehler des Jobs bzw. Auftrags.
Wird der Wert true für diesen Parameter angegeben, dann werden
Ausgaben nach stderr nicht als Fehler gemeldet.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
jump_password
|
|
|
[optional]
|
|
|
jump_port
|
|
|
[optional]
|
Port des
→jump_host
, über den Dateien gesendet werden.
Für FTP meist Port 21, für SFTP meist Port 22.
|
|
jump_protocol
|
|
|
[optional]
|
Bei Verwendung eines
→jump_host
werden Dateien zunächst auf diesen
Server transferiert und anschließend an das Zielsystem. Dabei können unterschiedliche
Protokolle (FTP/SFTP) für die beiden Transferoperationen verwendet werden.
Der Parameter nimmt die Werte
ftp, sftp oder ftps an.
Bei Verwendung von sftp werden auch die jump_ssh_*-Parameter
ausgewertet.
|
|
jump_proxy_host
|
|
|
[optional]
|
Der Wert des Parameters ist der Hostname oder die IP-Adresse eines Proxies,
über den die Verbindung zum jump host hergestellt wird.
Die Verwendung von Proxies ist optional.
|
|
jump_proxy_password
|
|
|
[optional]
|
Der Wert des Parameters enthält das Kennwort einer Benutzerkennung
zur Autorisierung am Proxy Server, wenn die Verbindung zum jump
host über einen Proxy hergestellt wird,
siehe Parameter
→jump_proxy_host
.
|
|
jump_proxy_port
|
|
|
[optional]
|
Der Wert des Parameters ist der Port des Proxies, über den eine Verbindung
zum jump host hergestellt wird,
siehe Parameter
→jump_proxy_host
.
|
|
jump_proxy_user
|
|
|
[optional]
|
Der Wert des Parameters enthält den Namen einer Benutzerkennung
zur Autorisierung am Proxy Server, wenn die Verbindung zum jump
host über einen Proxy hergestellt wird,
siehe Parameter
→jump_proxy_host
.
|
|
jump_simulate_shell
|
|
|
[optional]
|
Wird der Wert true für diesen Parameter angegeben, dann wird ein Login
an der Shell simuliert, um die Befehle auszuführen. Manche Scripte haben
Probleme, wenn keine Shell vorhanden ist.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
jump_simulate_shell_inactivity_timeout
|
|
|
[optional]
|
Wenn während der angegebenen Dauer von Millisekunden keine neuen Zeichen nach
stdout oder stderr geschrieben werden, wird angenommen, dass das Kommando
ausgeführt wurde und die Shell auf eine Befehlseingabe wartet.
| DataType: SOSOptionInteger |
| Default-Value:
---
|
|
|
jump_simulate_shell_login_timeout
|
|
|
[optional]
|
Wenn während der angegebenen Dauer von Millisekunden keine neuen Zeichen nach
stdout oder stderr geschrieben werden, wird angenommen, dass der Login
ausgeführt ist und die Shell auf eine Befehlseingabe wartet.
| DataType: SOSOptionInteger |
| Default-Value:
---
|
|
|
jump_simulate_shell_prompt_trigger
|
|
|
[optional]
|
Der erwartete Prompt an der Kommandozeile. Damit kann festgestellt werden, ob
Befehle eingegeben werden können, bzw. ausgeführt wurden. Kann
kein Prompt konfiguriert werden, so müssen timeout Werte verwendet werden,
wennn geprüft werden soll, ob die Shell Kommandos entgegennimmt.
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
jump_ssh_auth_file
|
|
|
[optional]
|
Der Parameter bestimmt den Pfad und Namen einer Datei mit dem Private Key
des Benutzers, für den die Anmeldung am SSH Server des
→jump_host
erfolgt.
Der Parameter muss angegeben werden, wenn mit dem Parameter
→jump_ssh_auth_method
die Authentifizierungsmethode publickey bestimmt wurde.
Falls die Datei mit einer Passphrase geschützt ist, wird die Passphrase mit dem Parameter
→jump_password
angegeben.
|
|
jump_ssh_auth_method
|
|
|
[optional]
|
Der Parameter spezifiziert die Authentifizierungsmethode am SSH Server des
→jump_host
,
unterstützt werden publickey und password.
Bei Verwendung der Authentifizierungsmethode publickey muss
im Parameter
→jump_ssh_auth_file
der Pfad der Datei mit dem Private Key
des Benutzers angegeben werden. Ist diese Datei mit einer Passphrase geschützt,
dann muss die Passphrase mit dem Parameter
→jump_password
angegeben werden.
Bei Verwendung der Authentifizierungsmethode password wird das
Kennwort des Benutzers mit dem Parameter
→jump_password
angegeben.
Welche Authentifizierungsmethoden unterstützt werden, ist am SSH Server konfiguriert.
Nicht alle SSH Server sind für die Authentifizierungsmethode password konfiguriert.
|
|
jump_user
|
|
|
[optional]
|
|
|
local_dir
|
|
|
[required]
|
Lokales Verzeichnis, in das bzw. von dem Dateien übertragen werden.
Per Voreinstellung wird das Arbeitsverzeichnis verwendet.
Neben Verzeichnissen im lokalen Dateisystem werden UNC Namen unterstützt,
mit denen Verzeichnisse auf anderen Servern adressiert werden können:
\\somehost\somedirectory kann genau wie
//somehost/somedirectory verwendet werden, um Dateien
von einem FTP/SFTP Server direkt auf einen anderen entfernten Server zu übertragen.
Darüber hinaus können URIs für ein file-Schema angegeben werden, z.B.
file:////somehost/somedirectory.
Beachten Sie bitte die erforderliche Anzahl Schrägstriche. file-URIs
unterliegen folgenden, durch das verwendete Java JRE bedingte Limitationen:
- Es können keine Dateien mit Leerzeichen im Pfad oder Dateinamen verarbeitet werden
-
Authentifizierung anhand von
authority strings, z.B.
file:////user:password@somehost/somedirectory
wird nicht unterstützt.
| DataType: SOSOptionFolderName |
| Default-Value: . |
|
|
log_filename
|
Der Name (und Pfadname) der Protokoll-Datei
|
|
[optional]
|
Der Name (und Pfadname) der Protokoll-Datei
Der Parameter benennt eine Datei, in die alle Protokollausgaben
vorgenommen werden.
Ist die Datei noch nicht vorhanden, dann wird sie angelegt.
An eine bestehende Datei werden Protokollausgaben angehängt.
Ohne Verwendung dieses Parameters erfolgen Protokollausgaben nach stdout.
| DataType: SOSOptionOutFileName |
| Default-Value:
---
|
|
|
mandator
|
|
|
[optional]
|
Der Parameter nimmt die Bezeichnung eines Mandanten auf, für den der File Transfer ausgeführt wird.
Der Mandant wird in eine ggf. verwendete Historiendatei übernommen, siehe Parameter
→history
,
er hat keine technische Relevanz für den Transfer.
| DataType: SOSOptionString |
| Default-Value: SOS |
|
|
operation
|
Die auszuführende Operation
|
|
[required]
|
Die auszuführende Operation
send, receive, remove, execute oder install.
- send - Dateien mit FTP/SFTP versenden
- receive - Dateien mit FTP/SFTP empfangen
- remove - Dateien mit FTP/SFTP auf einem anderen Server-System entfernen
- execute - Kommando per SSH auf einem anderen Server-System ausführen
- install - SOSFTP-Client auf einem anderen Server-System installieren
| DataType: SOSOptionStringValueList |
| Default-Value: send |
|
|
overwrite_files
|
|
|
[optional]
|
Der Parameter bestimmt, ob ggf. vorhandene Dateien überschrieben werden sollen.
Wird dieser Parameter gemeinsam mit
→force_files
verwendet und verhindert er
den Transfer von Dateien wg. Überschreibschutz, dann wird ggf. ein Fehler ausgeworfen
mit dem Hinweis "no matching files".
| DataType: SOSOptionBoolean |
| Default-Value: true |
|
|
passive_mode
|
passive_mode
|
|
[optional]
|
passive_mode
Der Passiv-Modus wird oft für FTP z.B. beim Betrieb mit Firewalls eingesetzt.
Erlaubte Werte sind
0
oder
1.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
password
|
Das zur Nutzerkennung passende Kennwort
|
|
[optional]
|
Das zur Nutzerkennung passende Kennwort
Kennwort zur Anmeldung am FTP/SFTP Server.
Fall SSH/SFTP Verbindungen mit private/public key Authentifizierung
verwendet werden, dann spezifiziert dieser Parameter die Passphrase,
mit der ggf. ein privater Schlüssel geschützt ist.
| DataType: SOSOptionPassword |
| Default-Value:
---
|
|
|
poll_interval
|
|
|
[optional]
|
Der Parameter bestimmt das Intervall in Sekunden, wie oft das Vorhandensein einer Datei
innerhalb des mit dem Parameter
→poll_timeout
benannten Zeitraums geprüft wird.
| DataType: SOSOptionInteger |
| Default-Value: 60 |
|
|
poll_minfiles
|
|
|
[optional]
|
Der Parameter bestimmt wie viele Dateien mindestens gefunden werden
müssen, damit der Transfer beginnt. Dieser Parameter ist nur wirksam in Zusammenhang
mit dem Parameter
→poll_timeout
.
| DataType: SOSOptionInteger |
| Default-Value: 1 |
|
|
poll_timeout
|
|
|
[optional]
|
Der Parameter bestimmt den Zeitraum in Minuten, wie lange bis zum Vorhandensein einer Datei
abgewartet wird.
Trifft innerhalb der Wartezeit eine Datei ein, so wird sie übertragen;
andernfalls wird ein Fehler "no matching files" ausgeworfen.
| DataType: SOSOptionInteger |
| Default-Value: 0 |
|
|
port
|
zu verwendende Port-Nummer des Protokolls
|
|
[required]
|
zu verwendende Port-Nummer des Protokolls
Port, über den Dateien gesendet werden.
Für FTP meist Port 21, für SFTP meist Port 22.
| DataType: SOSOptionPortNumber |
| Default-Value: 21 |
|
|
ppid
|
|
|
[optional]
|
Der Parameter wird unter Unix verwendet und - abweichend von anderen Parametern -
i.d.R. bereits im Start Script sosftp.sh eingesetzt.
Als Wert wird die Umgebungsvariable $PPID übergeben, die
die Prozessnummer des aktuellen Vaterprozesses (PPID) enthält.
Diese Prozessnummer wird beim Schreiben einer Historiendatei für jeden Transfer
protokolliert (siehe Parameter
→history
),
um nachvollziehbar zu halten, von welchem Prozess Dateien übertragen wurden.
| DataType: SOSOptionProcessID |
| Default-Value:
---
|
|
|
profile
|
Der Name eines auszuführenden Profils
|
|
[optional]
|
Der Name eines auszuführenden Profils
Bei Verwendung einer Konfigurationsdatei (siehe Parameter settings)
benennt dieser Parameter eine Sektion, d.h. ein Profil, der Konfigurationsdatei.
Sektionen enthalten Parameter als Paare aus Namen und Wert, die andernfalls
als Kommandozeilenparameter aufgeführt werden.
An der Kommandozeile wird der Name der Einstellungsdatei und des Profils wie folgt angegeben:
sosftp.sh -operation=send -settings=settings.ini -profile=sample_transfer ...
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
protocol
|
Art des Datenübertragungsprotokolls
|
|
[required]
|
Art des Datenübertragungsprotokolls
Der Parameter nimmt die Werte ftp, sftp oder ftps an.
Bei Verwendung von sftp werden auch die ssh_*-Parameter
ausgewertet.
| DataType: SOSOptionStringValueList |
| Default-Value: ftp |
|
|
recursive
|
Unterverzeichnisse durchsuchen
|
|
[optional]
|
Unterverzeichnisse durchsuchen
Der Parameter gibt an, ob Dateien aus Unterverzeichnissen des
Quellverzeichnisses rekursiv übertragen werden.
Nur wirksam, wenn
→file
ein Verzeichnis ist.
Reguläre Ausdrücke, wie sie der Parameter
→file_spec
spezifiziert,
werden auf die Dateien in Unterverzeichnissen angewendet.
Gültige Werte:
true, 1, on, yes, y, ja, j
und
false, 0, off, no, n, nein
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
remote_dir
|
remote_dir
|
|
[required]
|
remote_dir
Verzeichnis am FTP/SFTP Server, von dem bzw. zu dem Dateien übertragen werden.
Per Voreinstellung wird das Home-Verzeichnis des Benutzers am FTP/SFTP Server verwendet.
| DataType: SOSOptionFolderName |
| Default-Value: . |
|
|
remove_files
|
|
|
[optional]
|
Der Parameter bestimmt, ob nach dem Transfer Dateien auf dem FTP/SFTP Server entfernt werden sollen.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
replacement
|
Zeichenkette für Substitution
|
|
[optional]
|
Zeichenkette für Substitution
Zeichenkette für die Ersetzung desjenigen Ausdrucks für Dateinamensbestandteile,
der im Wert des Parameters
→replacing
angegeben ist.
Sollen mehrere Gruppen ersetzt werden, dann muss pro Gruppe eine Zeichenkette angegeben werden. Diese werden mit einem Semikolon ";" voneinander getrennt:
replacement: aa;[filename:];bb
Unterstützt Substitution von Masken im Dateinamen mit Formatangaben, die mit
[
und
]
geklammert sind.
Folgende Formate werden unterstützt:
-
[date:
date format
]
date format
muss ein gültiger Java Format-String für Datumsangaben sein, z.B.
yyyyMMddHHmmss
,
yyyy-MM-dd.HHmmss
etc.
-
[filename:]
Wird durch den ursprünglichen Dateinamen einschließlich Dateiendung ersetzt.
-
[filename:lowercase]
Wird durch den ursprünglichen Dateinamen einschließlich Dateiendung in Kleinbuchstaben ersetzt.
-
[filename:uppercase]
Wird durch den ursprünglichen Dateinamen einschließlich Dateiendung in Großbuchstaben ersetzt.
Erfordert den Parameter
→replacing
.
| DataType: SOSOptionString |
| Default-Value:
---
|
|
|
replacing
|
Regulärer Ausdruck für Text-Ersetzung
|
|
[optional]
|
Regulärer Ausdruck für Text-Ersetzung
Regulärer Ausdruck für Dateinamensersetzung mit
dem Wert des Parameters
→replacement
.
Wenn der Ausdruck im Dateinamen gefunden wird, werden die gefundenen
Gruppen ersetzt.
a)
Für die Ersetzung werden "capturing groups" verwendet. D.h. nur der
Inhalt der Gruppen wird ersetzt.
Ersetzungszeichenfolgen werden mit einem Semikolon ";" getrennt.
Beispiel:
→replacing
= (1)abc(12)def(.*)
→replacement
= A;BB;CCC
Name der Eingabedatei: 1abc12def123.txt
Daraus gebildeter Name der Ausgabedatei: AabcBBdefCCC
b)
Werden keine "capturing groups" angegeben, dann wird die gesamte
Übereinstimmung ersetzt. Beispiel:
→replacing
= Hallo
→replacement
= 1234
Name der Eingabedatei: Hallo_Welt.txt
Daraus gebildeter Name der Ausgabedatei: 1234_Welt.txt
Erfordert den Parameter
→replacement
.
Beispiele:
source_file
|
file_spec
|
replacing
|
replacement
|
Beispiel |
Ergebnis |
Kommentar |
| ./temp |
.* |
~ |
"" |
hallo.dat~ |
hallo.dat |
- |
| a.txt |
- |
[.]txt |
_2006-11-24.txt |
- |
a_2006-11-24.txt |
- |
| ./temp |
.* |
.* |
[filename:] [date:yyyy-MM-dd].dat |
a.txt |
a.txt2006-11-24.dat |
[filename:] und [date:] werden substituiert nachdem die
Ersetzung durchgeführt wurde |
| ./temp |
.*[.]txt |
a.*?b |
world |
a.1.b.txt.b |
world.txt.b |
.*? : Verwendung von .* im Modus "ungreedy" |
| abcdefg.txt |
- |
^(ab)cde(fg)[.]txt |
123;[date:yyyy-MM-dd] |
- |
123cde2006-11-24.txt |
; : Trennzeichen zwischen mehreren Ersetzungsstrings |
| ./temp |
.*dat$ |
(ab)_c[0-9]d_(fg) |
group1;group2 |
ab_c1d_fg. ab_c2d_fg.dat |
group1_c1d_group2. ab_c2d_fg.dat |
Nur die erste Übereinstimmung des Musters wird ersetzt. |
| ./temp |
.* |
^(?:aa|bb)_.{2}_ ([0-9]+_[0-9]+)$ |
tail |
aa_QU_061205_222334 |
aa_QU_tail |
(?:...) : "?:" Spezifiziert eine "non capturing group". Diese
wird nicht ersetzt. |
| ./temp |
FILE.txt |
.* |
[filename:lowercase]_[filename:uppercase]_[filename:] |
FILE.txt |
file.txt_FILE.TXT_FILE.txt |
- |
source_file
|
target_file
|
file_spec
|
create_dir
|
replacing
|
replacement
|
Beispiel |
Ergebnis |
Kommentar |
| aaa/bbb/ |
[directory:]/[date:yyyyMMdd]/ |
hello.txt |
true |
[.]txt |
[date:yyyy].txt |
aaa/bbb/hello.txt |
aaa/bbb/20070316/hello2007.txt |
Wenn das Verzeichnis aaa/bbb/20070316 noch nicht existiert,
wird es angelegt |
Für weitere Informationen zu regulären Ausdrücken, siehe
java.util.regex.Pattern
| DataType: SOSOptionRegExp |
| Default-Value:
---
|
|
|
root
|
|
|
[optional]
|
Der Parameter benennt das Verzeichnis, in dem dieses Programm
temporäre Dateien erzeugen kann. Temporäre Dateien werden
benötigt, wenn mittels
→jump_host
Dateien auf
einem Server zwischengespeichert und nach Abschluss des
Transfers entfernt werden sollen.
Ohne Angabe dieses Parameters wird der Name des Verzeichnises für temporäre Dateien
vom Betriebssystem übernommen.
| DataType: SOSOptionFolderName |
| Default-Value:
---
|
|
|
scheduler_host
|
|
|
[optional]
|
Der Parameter benennt den Host-Namen oder die IP-Adresse eines Servers, auf dem ein
JobScheduler für den "Managed File Transfer" betrieben wird.
Per Job Scheduling wird automatisiert der Inhalt einer ggf. verwendeten Historiendatei
(siehe Parameter
→history
) in eine zentrale Datenbank übernommen.
Dieser Parameter veranlasst die Übertragung der Historieneinträge
für den aktuellen Transfer per UDP an den Job Scheduler. Sollte der Job Scheduler
nicht erreichbar sein, dann wird kein Fehler gemeldet, stattdessen wird der Inhalt
der Historiendatei nachträglich automatisch vom Job Scheduler verarbeitet.
| DataType: SOSOptionHostName |
| Default-Value: localhost |
|
|
scheduler_job_chain
|
|
|
[optional]
|
Der Name einer Job-Kette für den Managed File Transfer im Job Scheduler,
siehe Parameter
→scheduler_host
.
Die Job-Kette nimmt einen Historieneintrag entgegen und importiert ihn in
eine zentrale Datenbank.
| DataType: JSJobChain |
| Default-Value: scheduler_sosftp_history |
|
|
scheduler_port
|
|
|
[optional]
|
Der TCP-Port, über den mit dem JobScheduler kommuniziert werden kann.
Siehe auch den Parameter
→scheduler_host
.
| DataType: SOSOptionPortNumber |
| Default-Value: 4444 |
|
|
settings
|
Name der INI-Datei mit den Profilen
|
|
[optional]
|
Name der INI-Datei mit den Profilen
Bei Verwendung einer Konfigurationsdatei werden Profile als Sektionen eingerichtet und einzelne Parameter als Paare aus Namen
und Wert in einem einfach Textformat aufgeführt:
[sample_transfer]
protocol = ftp
host = localhost
port = 21
local_dir = /tmp
...
An der Kommandozeile wird der Name der Einstellungsdatei und des Profils angegeben:
sosftp.sh -operation=send -settings=settings.ini -profile=sample_transfer ...
Ein Profil kann den Inhalt anderer Profile wie folgt referenzieren:
[default]
history = /sosftp/transfer_history.csv
mandator = SOS
scheduler_host = localhost
scheduler_port = 4444
[sample_transfer]
include = default
protocol = ftp
host = www.sos-berlin.com
port = 21
local_dir = /tmp
...
In diesem Beispiel referenziert das Profil sample_transfer
mittels include das default Profil
und übernimmt die Einstellungen für die Historienverarbeitung.
| DataType: SOSOptionIniFileName |
| Default-Value: ./SOSFtpSettings.ini |
|
|
skip_transfer
|
|
|
[optional]
|
Enthält dieser Parameter den Wert true, dann werden alle Operationen
ausser dem eigentlichen Transfer durchgeführt.
Dadurch kann z.B. nur getriggert oder nur auf dem FTP/SFTP Server gelöscht werden.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
ssh_auth_file
|
|
|
[optional]
|
Der Parameter bestimmt den Pfad und Namen einer Datei mit dem Private Key
des Benutzers, für den die Anmeldung am SSH Server erfolgt.
Der Parameter muss angegeben werden, wenn mit dem Parameter
→ssh_auth_method
die Authentifizierungsmethode publickey bestimmt wurde.
Falls die Datei mit einer Passphrase geschützt ist, wird diese mit dem Parameter
→password
angegeben.
| DataType: SOSOptionInFileName |
| Default-Value:
---
|
|
|
ssh_auth_method
|
|
|
[optional]
|
Der Parmeter spezifiziert die Authentifizierungsmethode am SSH Server, unterstützt
werden publickey und password.
Bei Verwendung der Authentifizierungsmethode publickey muss
im Parameter
→ssh_auth_file
der Pfad der Datei mit dem Private-Key
des Benutzers angegeben werden. Ist diese Datei mit einer Passphrase geschützt,
dann muss diese mit dem Parameter
→password
angegeben werden.
Bei Verwendung der Authentifizierungsmethode password wird das
Kennwort des Benutzers mit dem Parameter
→password
angegeben.
Welche Authentifizierungsmethoden unterstützt werden, ist am (SSH-) Server konfiguriert.
Nicht alle (SSH-) Server sind für die Authentifizierungsmethode password konfiguriert.
| DataType: SOSOptionStringValueList |
| Default-Value: publickey |
|
|
ssh_proxy_host
|
|
|
[optional]
|
Der Wert des Parameters ist der Hostname oder die IP-Adresse eines Proxies,
über den die Verbindung zum SSH Server hergestellt wird.
Die Verwendung von Proxies ist optional.
|
|
ssh_proxy_password
|
|
|
[optional]
|
Der Wert des Parameters enthält das Kennwort einer Benutzerkennung
zur Autorisierung am Proxy Server, wenn die Verbindung zum SSH
Server über einen Proxy hergestellt wird.
|
|
ssh_proxy_port
|
|
|
[optional]
|
Der Wert des Parameters ist der Port des Proxies, über den eine Verbindung
zum SSH Server hergestellt wird.
|
|
ssh_proxy_user
|
|
|
[optional]
|
Der Wert des Parameters enthält den Namen einer Benutzerkennung
zur Autorisierung am Proxy Server, wenn die Verbindung zum SSH
Server über einen Proxy hergestellt wird.
|
|
transactional
|
|
|
[optional]
|
Der Parameter bestimmt, ob ob die Dateiübertragung innerhalb einer Transaktion abläuft,
d.h. es werden entweder alle Dateien erfolgreich übertragen oder keine.
Tritt bei der Übertragung einer Datei ein Fehler auf, dann werden die Übertragungen
aller bis dahin übertragenen Dateien rückgängig gemacht ("zurückgerollt").
Wird der Parameter mit dem Wert true verwendet, dann wirken folgende Parameter:
- Der Parameter
→atomic_suffix
muss angegeben sein, der
Zieldateien zunächst mit einem Suffix, z.B. "~", erzeugt
und nach vollständiger Übertragung in den Zieldateinamen umbenennt.
Ist die Übertragung einer von mehreren Dateien nicht erfolgreich, dann
wird keine Datei in den Zieldateinamen umbenannt, stattdessen werden die
temporär erzeugten Dateien aus dem Zielsystem entfernt.
- Der Parameter
→remove_files
, der das Entfernen der übertragenen
Dateien aus dem Quellsystem veranlasst, wirkt erst nachdem alle Dateien
erfolgreich übertragen wurden. Andernfalls wird keine Datei entfernt.
| DataType: SOSOptionBoolean |
| Default-Value: false |
|
|
transfer_mode
|
Art der Zeichencodierung
|
|
[optional]
|
Art der Zeichencodierung
Der Transfer-Modus gilt für das FTP-Protokoll und kann die Werte
ascii
oder
binary
annehmen.
| DataType: SOSOptionTransferMode |
| Default-Value: binary |
|
|
user
|
Kennung/Identifikation des Nutzers
|
|
[required]
|
Kennung/Identifikation des Nutzers
Benutzername zur Anmeldung am (FTP/SFTP) Server.
| DataType: SOSOptionUserName |
| Default-Value: anonymous |
|
|
verbose
|
Granularität der Protokollierung von (Debug-)Meldungen
|
|
[optional]
|
Granularität der Protokollierung von (Debug-)Meldungen
Der verbosity level bestimmt die Intensität der Protokollierung.
Als Wert kann eine Zahl zwischen 1 und 9 angegeben werden.
Höhere Werte erzeugen detailliertere Protkollausgaben.
Die Protokollausgabe erfolgt nach stdout bzw. in die mit dem Parameter
→log_filename
angegebene Datei.
| DataType: SOSOptionInteger |
| Default-Value: 10 |
|
|
zero_byte_transfer
|
|
|
[optional]
|
Der Parameter legt fest, ob Dateien mit 0 Byte Größe übertragen und ggf. in nachfolgenden Kommandos verarbeitet werden sollen.
Folgende Einstellungen sind möglich:
-
yes
: Dateien mit 0 Byte Größe werden übertragen (Voreinstellung).
-
no
: Dateien mit 0 Byte Größe werden übertragen, wenn mindestens eine
der übertragenen Dateien mehr als 0 Byte Größe aufweist.
-
strict
: es werden keine Dateien mit 0 Byte Größe übertragen.
Werden Dateien mit 0 Byte Größe gefunden, dann wird
ein Fehler ausgelöst bzw. ein Auftrag beendet.
-
relaxed
: es werden keine Dateien mit 0 Byte Größe übertragen,
allerdings wird kein Fehler ausgelöst, wenn dadurch keine Dateien übertragen werden konnten.
Ein Auftrag wird ggf. als erledigt markiert.
Die Verwendung kann mit dem Parameter
→force_files
erweitert werden:
enthält dieser Parameter den Wert
false,
dann wird ein Auftrag fortgesetzt,
auch wenn keine Dateien übertragen wurden.
Der Parameter
→remove_files
gilt uneingeschränkt. Dateien werden entfernt,
unabhängig davon, ob sie wg. 0 Byte Größe übertragen wurden oder nicht.
| DataType: SOSOptionStringValueList |
| Default-Value: yes |
|
|
*
|
|
|
[optional]
|
Beliebige weitere Parameter ohne Schlüsselwort stellen die Pfade von
Dateien dar,
die transferiert werden sollen.
|
