Configuration, programming
4.7 FTP communication
CP 1543-1
54
Operating Instructions, 12/2019, C79000-G8976-C289-08
Parameter
Type
Range of values
Meaning / remarks
DataBlockNumber
UINT
The data block specified here contains the file DB to be
read / written.
LenFilename
UINT
0...1000
The "LenFilename" parameter for specifying the total length
of the file name is not evaluated.
Instead, the length information in the string of the "File-
name" parameter is evaluated.
Filename
ARRAY[0..3] OF
STRING[254]
File name of the destination or source file.
The four strings for the file name are concatenated and
transferred to the server as a complete string.
Parameter supply for command types NOOP and QUIT
Supply the FTP_CMD with a reference to a job block with the following command types as
well:
CMD = 0 (NOOP)
CMD = 5 (QUIT)
The content of the job block is not evaluated when these command types execute, the type
(UDT) of the specified job block is therefore unimportant.
Note
Response if the reference to the FTP job block is missing
If this reference is not supplied, the command is not executed. The instruction remains
blocked in an apparent execution status without any feedback to the user program on the
interface.
4.7.2.4
Output parameters and status information FTP_CMD
Parameters BUSY, DONE and ERROR
You control the execution status with the parameters BUSY, DONE, ERROR and STATUS.
The BUSY parameter indicates the processing status. With the DONE parameter, you check
whether or not a job was correctly executed. The ERROR parameter is set if errors occur
during execution of "FTP_CMD". Error information is output in the STATUS parameter.
The following table shows the relationship between the parameters BUSY, DONE and
ERROR:
BUSY
DONE
ERROR Description
1
-
-
The job is being processed.
0
1
0
The job was completed successfully.
0
0
1
The job was terminated with an error. The cause of the error is specified in the STATUS
parameter.
0
0
0
No new job was assigned.
