Job block for the RETR_PART FTP command
The following data structure is used for the RETR_PART FTP command.
Table 4- 8
FTP_FILENAME_PART
Parameter
InterfaceID
HW_ANY
ID
CONN_OUC
ConnectionType
BYTE
ActiveEstablishment BOOL
FTPcmd
BYTE
CertIndex
BYTE
Offset
DWORD
Length
DWORD
CP 1543-1
Operating Instructions, 12/2019, C79000-G8976-C289-08
Type
Range of values
1, 2...64
0
TRUE
7
0 = FTP
1 = FTPS
Meaning / remarks
Module start address
When you call an instruction, you transfer the module start
address of the CP in the LADDR parameter.
You will find the module start address of the CP in the
configuration of the CP under: "Proper-
ties>Addresses>Inputs"
The FTP jobs are handled on FTP connections. The pa-
rameter identifies the connection being used.
Connection type "FTP"
TRUE = active connection establishment
FTP command "RETR_PART"
FTP command that executes when the instruction is called.
You can find the value ranges for the command types in
the section Input parameter - FTP_CMD (Page 47).
The FTP command specified here must be specified identi-
cally in the CMD input parameter.
Here, choose between the protocol types FTP or FTPS.
Note on FTPS: If the FTP server is configured outside the
STEP 7 project of the FTP client, the certificate must be
imported from the FTP server.
Offset in bytes starting at which the file will be read.
Sublength in bytes that is read starting at the value speci-
fied in "OFFSET".
Special features:
If "DW#16#FFFFFFFF" is specified, the available rest of
•
the file will be read.
Result OK (DONE = 1, STATUS = 0) if no other error
occurred.
When OFFSET > length of the original file:
•
Length of the destination file (ACT_LENGTH in file DB):
0 bytes on the CPU.
Result OK (DONE = 1, STATUS = 0) if no other error
occurred.
When OFFSET + LEN > length of the original file (and
•
LEN ≠ 0xFFFFFFFF):
Length of the destination file (ACT_LENGTH in file DB):
Available bytes starting at "OFFSET".
Result OK (DONE = 1, STATUS = 0) if no other error oc-
curred.
Configuration, programming
4.7 FTP communication
53