Einsatzhinweis
Funktion: Datei synchron übertragen
Benutzergruppe: FT-Benutzer
Aliasname: FTSCOPY
Funktionsbeschreibung
Mit dem Kommando TRANSFER-FILE-SYNCHRONOUS erteilen Sie einen synchronen Auftrag, um eine oder mehrere Dateien in das ferne System zu senden oder aus dem fernen System zu holen.
Die Syntax ist bis auf einige Ausnahmen identisch zum Kommando TRANSFER-FILE. Daher wird nur die Syntax beschrieben.
TRANSFER-FILE-SYNCHRONOUS unterscheidet sich von TRANSFER-FILE in folgenden Punkten:
Es gibt keine lokale Folgeverarbeitung. Daher entfallen die lokalen Parameter PROCESSING-ADMISSION, SUCCESS-PROCESSING, FAILURE-PROCESSING.
Die lokalen Parameter LISTING, MONJV, JV-PASSWORD werden nicht unterstützt.
Die allgemeinen Parameter PRIORITY, START und CANCEL entfallen, da diese im synchronen Fall nicht sinnvoll sind.
Für das FTAM-Protokoll gilt: Pro FTSCOPY-Kommando können auch mehrere Dateien geholt und gesendet werden. Dies wird dadurch gesteuert, dass der Dateiname mit zwei Kommas beginnt. Details siehe openFT-Handbuch "Konzepte und Funktionen", Abschnitt "Besonderheiten beim File Transfer mit FTAM-Partnern".
Der Name der bisher unter dem gleichen Namen angebotenen Kommandoprozedur ändert sich zu START-TRANSFER-FILE-SYNCH.
Format
TRANSFER-FILE-SYNCHRONOUS / FTSCOPY |
TRANSFER-DIRECTION = TO-PARTNER / FROM-PARTNER ,PARTNER = <text 1..200 with-low> ,LOCAL-PARAMETER = *PAR AMETERS(...) *PARAMETERS(...) FILE-NAME = *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) / *POSIX(NAME=<posix-pathname 1..510>) *LIBRARY-ELEMENT(...) LIBRARY = *NOT-SPECIFIED / <filename 1..54> ,ELEMENT = *NOT-SPECIFIED / <filename 1..64 without-gen-vers>(...) / <composed-name 1..64 with-under>(...) <filename>(...) / composed-name>(...) VERSION = *STD / <text 1..24> ,TYPE = *NOT-SPECIFIED / <alphanum-name 1..8> ,PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET ,TRANSFER-ADMISSION = *SAME / <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE / <alphanum-name 1..8> ,PASSWORD = *NONE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16> / *SECRET ,CODED-CHARACTER-SET = *STD / <name 1..8> ,REMOTE-PARAMETER = *BS2 000(...) / *MSP(...) / *ANY(...) *BS2 000(...) FILE-NAME = *SAME / *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) / *POSIX(NAME=<posix-pathname 1..510>) *LIBRARY-ELEMENT(...) LIBRARY = *SAME / *NOT-SPECIFIED / <filename 1..54> ,ELEMENT = *SAME / *NOT-SPECIFIED / <filename 1..64 without-gen-vers>(...) / <composed-name 1..64 with-under>(...) <filename>(...) / <composed-name>(...) VERSION = *SAME / *STD / <text 1..24> ,TYPE = *SAME / *NOT-SPECIFIED / <alphanum-name 1..8> ,PASSWORD = *SAME / *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET ,TRANSFER-ADMISSION = *SAME / <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low>/ *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE / <alphanum-name 1..8> ,PASSWORD = *NONE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16> / *SECRET ,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE / <alphanum-name 1..8> ,PASSWORD = *NONE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16> / *SECRET ,SUCCESS-PROCESSING = *NONE / <c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,FILE-AVAILABILITY = *BY-RECEIVING-SYSTEM / *IMMEDIATE / *DEFERRED ,ACCESS-MODE = *BY-RECEIVING-SYSTEM / *PARAMETERS(...) *PARAMETERS(...) READ-FILE = *NO / *YES ,INSERT-DATA-UNIT = *NO / *YES ,REPLACE-FILE = *NO / *YES ,EXTEND-FILE = *NO / *YES ,ERASE-DATA-UNIT = *NO / *YES ,READ-ATTRIBUTES = *NO / *YES ,CHANGE-ATTRIBUTES = *NO / *YES ,DELETE-FILE = *NO / *YES ,CODED-CHARACTER-SET = *STD / <name 1..8> *MSP(...) FILE-NAME = *NOT-SPECIFIED / <text 1..56> ,PASSWORD = *NONE / <alphanum-name 1..8> / *SECRET ,TRANSFER-ADMISSION = <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..7> ,ACCOUNT = *NONE / <text 1..43> ,PASSWORD = *NONE / <alphanum-name 1..8> / *SECRET ,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..7> ,ACCOUNT = *NONE / <text 1..43> ,PASSWORD = *NONE / <alphanum-name 1..8> / *SECRET ,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,CODED-CHARACTER-SET = *STD / <name 1..8> *ANY(...) FILE-NAME = *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low> / *LIBRARY-ELEMENT(...) *LIBRARY-ELEMENT(...) LIBRARY = *NOT-SPECIFIED / <c-string 1..63 with-low> ,ELEMENT = *NOT-SPECIFIED / <c-string 1..64 with-low>(...) <c-string 1..64 with-low>(...) VERSION = *NONE / *STD / <c-string 1..24 with-low> ,TYPE = *NONE / *NOT-SPECIFIED / <c-string 1..8 with-low> ,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128> / *SECRET ,TRANSFER-ADMISSION = *NONE / <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *SECRET / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <c-string 1..67 with-low> ,ACCOUNT = *NONE / <c-string 1..64 with-low> ,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128 with-low> / *SECRET ,PROCESSING-ADMISSION = *SAME / *NONE / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <c-string 1..67 with-low> ,ACCOUNT = *NONE / <c-string 1..64 with-low> ,PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128 with-low> / *SECRET ,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,FILE-AVAILABILITY = *BY-RECEIVING-SYSTEM / *IMMEDIATE / *DEFERRED ,STORAGE-ACCOUNT = *NONE / <c-string 1..40 with-low> / <text 1..40> ,ACCESS-MODE = *BY-RECEIVING-SYSTEM / *PARAMETERS(...) *PARAMETERS(...) READ-FILE = *NO / *YES ,INSERT-DATA-UNIT = *NO / *YES ,REPLACE-FILE = *NO / *YES ,EXTEND-FILE = *NO / *YES ,ERASE-DATA-UNIT = *NO / *YES ,READ-ATTRIBUTES = *NO / *YES ,CHANGE-ATTRIBUTES = *NO / *YES ,DELETE-FILE = *NO / *YES ,LEGAL-QUALIFICATION = *NONE / <c-string 1..80 with-low> / <text 1..80> ,CREATE-PASSWORD = *NONE / <c-string 1..64 with-low> / <x-string 1..128> / *SECRET ,CODED-CHARACTER-SET = *STD / <name 1..8> ,COMPRESS = *NONE / *BYTE-REPETITION / *ZIP ,WRITE-MODE = *REPLACE -FILE / *NEW-FILE / *EXTEND-FILE ,DATA-TYPE = *NOT-SPECIFIED / *CHARACTER (...) / *BINARY (...) / *USER *CHARACTER(...) TRANSPARENT = *NO / *YES *BINARY(...) TRANSPARENT = *NO / *YES ,DATA-ENCRYPTION = *NO / *YES / *ONLY-DATA-INTEGRITY ,RECORD-SIZE = *NOT-SPECIFIED /<integer 1..32756> ,RECORD-FORMAT = *STD / *FIXED / *VARIABLE / *UNDEFINED ,TARGET-FILE-FORMAT = *SAME / *BLOCK-ORIENTED / *SEQUENTIAL(...) *SEQUENTIAL(...) RECORD-FORMAT = *SAME / *UNDsEFINED ,FILE-NAME-ENCODING = *TRANSPARENT / *CHARACTER ,PROTECTION = *STD / *SAME ,LAST-CHANGE-DATE = *STD / *SAME |
Beschreibung der Operanden
Die Bedeutung der Operanden stimmt mit ihrer Bedeutung bei der asynchronen Dateiübertragung überein, siehe Operandenbeschreibung von TRANSFER-FILE.
Beispiel
Die Posix-Datei file.posix soll in das ferne Unix-System PUX übertragen werden. Dort soll sie in dem Verzeichnis dir (Unterverzeichnis des HOME-Verzeichnisses) unter der Zugangsberechtigung FuerUXSys abgelegt werden. Bei der Übertragung soll die zip-Komprimierung verwendet werden.
|
Kurzform:
/FTSCOPY TO,PUX,('./file.posix'),*a('dir/file.ux',,'FuerUXSys'),*ZIP