Mitsubishi Electric MELSEC iQ-R Series Programming Manual page 1133

• Wild card characters (*, ?) can be used in the file name or the extension specified in (s2).
Symbol Description
* An asterisk '*' is replaced with any character or string (including none) in a file name.
? A question mark '?' is replaced with a character (excluding none) in a file name. ('?' can be used multiple times.)
Wild card characters do not recognize periods.
Using wild card characters in the following ways results in an error.
• Two or more asterisks '*' are used in a file name (before the period) or an extension. (Example: *abc*.txt)
• An asterisk '*' and a question mark '?' are used in a file name (before the period) or an extension. (Example: *ab?. txt)
When any wild card character is used, the number of files that can be transferred is determined by the total size of the file
names of the specified files. The specified files can be transferred when the number of these files and the total size of the file
names satisfy the following condition. If a file transfer function instruction is executed without satisfying the following condition,
the instruction completes with an error.
(Fi + NM) + 1 < 65536 [bytes]
• If an error occurs in any one of the files to be retrieved during execution of the SP.FTPGET instruction, the transfer
processing will be stopped upon detection of the error, and the rest of target files will not be transferred.
• Untransferable files will not be transferred even though the wild card specification conditions are satisfied.
• If the number of characters in the file path which includes a file name and an extension exceeds 255, files will not be
transferred even though the wild card specification conditions are satisfied.
• If only a file name is specified by (s2), the CPU module directly accesses under the home directory of the FTP server. When
specifying only a file name, start with a delimiter. For details, follow the FTP server specifications.
• Specify the folder path of the transfer destination CPU module in (s3) in Unicode string. Use one-byte '\' or '/' as a delimiter
to specify the boundary of the folder path. The maximum number of characters in the folder path is 247 (246 when a
delimiter at the end of the string is omitted). Note that the total number of characters in a folder path (including the delimiter
at the end) and the file name specified in (s2) must be within the maximum path length (255 characters) supported by the
CPU module. The delimiter at the end of a string can be omitted. When omitted, '\' is assumed to be set at the end. If a
nonexistent folder path is specified, a folder is automatically created by the system at execution of the instruction, and then
the processing is performed.
247 characters maximum
[ ... "2:\database1\recipe\" ... ]
(1) (2)
(1)Drive numbers that can be specified are 2 to 4.
(2)Use one-byte ':\' or ':/' as a delimiter of the drive number.
(3)Use one-byte '\' or '/' as a delimiter to specify the boundary of the folder path.
(4)The delimiter at the end of string can be omitted.
• If a file with the same name exists in the transfer destination, the file will be overwritten.
• The maximum size of a file that can be retrieved is 4G bytes.
• The execution status and the completion status of the SP.FTPGET instruction can be checked with the completion device
(d) and the completion status indication device (d)+1.
• Completion device (d)
This device turns on during END processing of the scan where the SP.FTPGET instruction completes, and turns off during the next END processing.
• Completion status indication device (d)+1
This device turns on or off depending on the completion status of the SP.FTPGET instruction.
When completed successfully: The device remains off.
When completed with an error: The device turns on during END processing of the scan where the SP.FTPGET instruction completes, and turns off during the
next END processing. In addition, an error code is stored in the device specified by (s1)+1.
N: Total number of files that match the wild card specification
Fi: Total size of the file names that match the wild card specification
M: Specific information size (Fixed value: 6 bytes)
(3) (4)
8 BUILT-IN ETHERNET FUNCTION INSTRUCTIONS
8.5 File Transfer Function Instructions
8
1131