FP_FTP_SET_MODE_TRANSFER_LOG

设置数据记录文件的FTP传输模式

此FP指令通过FTP协议定义用于数据记录文件的传输设置。

参数

输入

nLogID (WORD, INT, UINT)

LOG编号（允许范围：0-15）。编译器将在内部生成LOG文件编号的字符串，例如'LOG=0'

sOperation (STRING)

设置传输方法参数。

服务器地址（须输入参数）

每次仅限指定一个服务器。请指定一个字节三个字符的FTP服务器编号。

关键字： SV

值：SV0–SV3（服务器0–服务器3）

传输方法（可选参数）

语法	传输方法
`'MODE=OVW'`	覆盖方法（默认）执行由数据记录设置指定文件名的文件传输。当传输因网络或服务器问题而中断时，可能只执行了部分文件传输。使用指令（如FP_FTP_GET_STATUS）检查传输是否已成功完成。
`'MODE=REN'`	重命名方法使用临时文件名执行文件的传输，并在成功完成传输后将文件重命名为指定文件名。要检查文件传输是否成功完成，请将实际文件名与数据记录设置指定的文件名进行比较。其处理时间长于覆盖方法的处理时间。

语法

传输方法

'MODE=OVW'

覆盖方法（默认）

执行由数据记录设置指定文件名的文件传输。当传输因网络或服务器问题而中断时，可能只执行了部分文件传输。使用指令（如FP_FTP_GET_STATUS）检查传输是否已成功完成。

'MODE=REN'

重命名方法

使用临时文件名执行文件的传输，并在成功完成传输后将文件重命名为指定文件名。要检查文件传输是否成功完成，请将实际文件名与数据记录设置指定的文件名进行比较。其处理时间长于覆盖方法的处理时间。

示例：使用重命名方法将数据记录文件发送到FTP服务器3：'SV3,MODE=REN'

sFTPServerDirectory (STRING)

设置目标目录（最大256个字符）。将从用户登录FTP服务器后分配到的原点目录中通过相对路径创建目标目录。如果不存在目标目录，则会自动将其创建成多至八个层级的结构。

输出

bError (BOOL)

在以下情况下将变为TRUE：

如果超过连接超时
如果 IP 地址无效

当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

标注

通过逗号分隔所有关键字输入。例如：'NAME=abcd,FROM=sender@server.com'
请勿更改关键字的顺序。按照此处所列顺序指定关键字及其设置参数。
字符串数据的字符数不得超过256。
此指令不可用于中断程序。
执行此指令前，需使用FP_FTP_SET_CONNECTION或FTP客户端的设置对话框指定FTP服务器。
大小写字符均可用于可指定字符常量的操作数。“Abcd”、“ABCD”和“abcd”意义相同，但是，文件名区分大小写。
仅当指定nLogID编号的传输请求标志为FALSE时，才能执行该指令。当传输请求标志为TRUE时，将发生运算错误。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
该指令将sOperation和sFTPServerDirectory的数据记录传输设置存储在由nLogID指定的LOG文件编号中。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果指定nLogID编号的数据记录条件为未注册。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。
如果未使用指令FP_FTP_SET_CONNECTION或FTP客户端的设置对话框配置FTP服务器。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果指定nLogID编号的数据记录条件为未注册。
如果为参数指定的值超出允许的范围。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。
如果未使用指令FP_FTP_SET_CONNECTION或FTP客户端的设置对话框配置FTP服务器。

sys_bIsCarry（对于一次扫描变为TRUE）

如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bSetLogTransferFTP: BOOL:=FALSE;
		bIsError: BOOL:=FALSE;
		bDisableLogTransferFTP: BOOL:=FALSE;
	END_VAR

POU本体

如果bSetLogTransferFTP和bDisableLogTransferFTP设置为TRUE，将执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 6 ;
        NETWORK_BODY
B(B_VARIN,,0,18,2,20,4,);
B(B_VARIN,,'SV0',18,3,20,5,);
B(B_VARIN,,'LogData',18,4,20,6,);
B(B_VAROUT,,bIsError,37,2,39,4,);
B(B_CONTACT,,bSetLogTransferFTP,5,1,7,3,);
B(B_F,FP_FTP_SET_MODE_TRANSFER_LOG!,,20,0,37,6,,?DEN?DnLogID?DsOperation?DsFTPServerDirectory?AENO?CbError);
L(1,2,5,2);
L(7,2,20,2);
L(1,0,1,6);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bDisableLogTransferFTP,5,1,7,3,);
B(B_VARIN,,0,18,2,20,4,);
B(B_VARIN,,'DISABLE',18,3,20,5,);
B(B_VAROUT,,bIsError,39,2,41,4,);
B(B_F,FP_FTP_TRANSFER_CONTROL_LOG!,,20,0,37,5,,?DEN?DnLogID?DsControl?AENO?AbError);
L(1,2,5,2);
L(37,3,39,3);
L(7,2,20,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If (bSetLogTransferFTP) Then
    FP_FTP_SET_MODE_TRANSFER_LOG(nLogID := 0, sOperation := 'SV0',
                                 sFTPServerDirectory := 'LogData', 
                                 bError => bIsError);
End_if;
If (bDisableLogTransferFTP) Then
    FP_FTP_TRANSFER_CONTROL_LOG(nLogID := 0, sControl := 'DISABLE', bError => bIsError);
End_if;