Note on usage
Function: Transfer file synchronously
User group: FT user
Functional description
With the FTSCOPY command, you issue a synchronous request to send one or more files to the remote system or to retrieve one or more files from the remote system.
With a few exceptions, the operands are identical to those of the NCOPY command. Consequently only the syntax is described.
FTSCOPY differs from NCOPY in the following points:
There is no local follow-up processing. The local parameters PROCESSING-ADMISSION, SUCCESS-PROCESSING and FAILURE-PROCESSING are therefore omitted.
The general parameters PRIORITY, START and CANCEL are not used, because they do not have any significance for synchronous transfer.
Format
FTSCOPY |
TRANSFER-DIRECTION = TO-PARTNER / FROM-PARTNER ,PARTNER = <text 1..200 with-low> ,LOCAL-PARAMETER = *PAR AMETERS(...) *PARAMETERS(...) FILE-NAME = *NOT-SPECIFIED /<filename 1..59> / <c-string 1..512 with-low> ,PASSWORD = *NONE / <alphanum-name 1..8> ,TRANSFER-ADMISSION = *SAME / <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE / <alphanum-name 1..40> / c-string 1..40> ,PASSWORD = *NONE / <alphanum-name 1..8> ,CODED-CHARACTER-SET = *STD / <alphanum-name 1..8> ,REMOTE-PARAMETER = *BS2 000(...) / *MSP(...) / *ANY(...) *BS2 000(...) FILE-NAME = *NOT-SPECIFIED / <filename 1..54> / <c-string 1..512 with-low>/ *LIBRARY-ELEMENT(...) *LIBRARY-ELEMENT(...) LIBRARY = *NOT-SPECIFIED / <filename 1..54> ,ELEMENT = *NOT-SPECIFIED / <filename 1..64 without-gen-vers>(...) / <composed-name 1..64 with-under>(...) / <number 1..ffff> <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> ,TRANSFER-ADMISSION = <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low>/ *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> ,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <alphanum-name 1..8> ,ACCOUNT = *NONE / <alphanum-name 1..8> ,PASSWORD = *NONE / <c-string 1..8> / <c-string 9..32> / <x-string 1..16> ,SUCCESS-PROCESSING = *NONE / <c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,CODED-CHARACTER-SET = *STD / <alphanum-name 1..8> *MSP(...) FILE-NAME = *NOT-SPECIFIED / <filename 1..59> / <c-string 1..512 with-low> ,PASSWORD = *NONE / <alphanum-name 1..8> ,TRANSFER-ADMISSION = <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE <alphanum-name 1..40> / <c-string 1..40> ,PASSWORD = *NONE / <alphanum-name 1..8> ,PROCESSING-ADMISSION = *SAME / *NOT-SPECIFIED / *PARAMETERS(...) *PARAMETERS(...) USER-IDENTIFICATION = <name 1..8> ,ACCOUNT = *NONE <alphanum-name 1..40> / <c-string 1..40> ,PASSWORD = *NONE / <alphanum-name 1..8> ,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,CODED-CHARACTER-SET = *STD / <alphanum-name 1..8> *ANY(...) FILE-NAME = *NOT-SPECIFIED / <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> ,TRANSFER-ADMISSION = *NONE / <alphanum-name 8..32> / <x-string 15..64> / <c-string 8..32 with-low> / *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> ,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> ,SUCCESS-PROCESSING = *NONE /<c-string 1..1000 with-low> ,FAILURE-PROCESSING = *NONE / <c-string 1..1000 with-low> ,CODED-CHARACTER-SET = *STD / <c-string 1..8 with-low> ,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 ,TABULATOR = *AUTO / *ON / *OFF ,TARGET-FILE-FORMAT = *SAME / *BLOCK-ORIENTED / *SEQUENTIAL(...) *SEQUENTIAL(...) RECORD-FORMAT = *SAME / *UNDEFINED ,FILE-NAME-ENCODING = *TRANSPARENT / *CHARACTER |
Operands
The meaning of the operands is the same as for asynchronous file transfer, see the operand description for NCOPY.
Example
The file EXAMPLE is to be transferred to the remote Unix system PUX. Here, it is to be stored in the directory dir (subdirectory of the HOME directory) under the transfer admission ForUXSys. ZIP compression is to be used for transfer.
|
Short form:
FTSCOPY TO,PUX,(EXAMPLE),*a('dir/file.ux',,'ForUXSys'),*ZIP