FP_SMTP_TRANSFER_CONTROL_LOG

控制数据记录文件的SMTP传输

此FP指令对由nLogID指定的数据记录文件的SMTP传输进行控制。有效控制字为'ENABLE'、'DISABLE'和'CANCEL'。

参数

输入

nLogID (WORD, INT, UINT)

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

sControl (STRING)

控制字符串：

'ENABLE'：启用文件传输
'DISABLE'：禁用文件传输
'CANCEL'：取消文件传输

输出

bError (BOOL)

在以下情况下将变为TRUE：

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

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

标注

字符串数据的字符数不得超过256。
执行指令前，需使用FP_SMTP_SET_MODE_TRANSFER_LOG或SMTP客户端的设置对话框指定数据记录文件的电子邮件传输设置。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
大小写字符均可用于可指定字符常量的操作数。“Abcd”、“ABCD”和“abcd”意义相同，但是，文件名区分大小写。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
处理传输取消请求需要一些时间。请使用FP_SMTP_GET_STATUS检查传输状态并确认传输是否会在执行指令后停止。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果为sControl指定了除'ENABLE'、'DISABLE'或'CANCEL'之外的任何控制字符串。
如果字符串数据的字符数超过256。
如果指定了未使用指令FP_SMTP_SET_MODE_TRANSFER_LOG或SMTP客户端的设置对话框配置的数据记录文件的电子邮件传输设置。

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

如果为sControl指定了除'ENABLE'、'DISABLE'或'CANCEL'之外的任何控制字符串。
如果字符串数据的字符数超过256。
如果指定了未通过指令FP_SMTP_SET_MODE或SMTP客户端的设置对话框配置的电子邮件传输设置。
如果指定了未使用指令FP_SMTP_SET_MODE_TRANSFER_LOG或SMTP客户端的设置对话框配置的数据记录文件的电子邮件传输设置。

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

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

示例

POU头

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

	VAR
		bIsError: BOOL:=FALSE;
		bSetLogTransferSMTP: BOOL:=FALSE;
		bDisableLogTransferSMTP: BOOL:=FALSE;
	END_VAR

POU本体

如果bSetLogTransferSMTP和bDisableLogTransferSMTP设置为TRUE，将执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'GRPNO=0~SUBJECTAUTO',19,3,21,5,);
B(B_VARIN,,'Sent Log Files',19,4,21,6,);
B(B_VARIN,,'INFO=NON~ATT=NONE',19,5,21,7,);
B(B_VAROUT,,bIsError,39,2,41,4,);
B(B_CONTACT,,bSetLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_SET_MODE_TRANSFER_LOG!,,21,0,39,7,,?DEN?DnLogID?DsGroupNumber_Subject?DsBodyText?DsAttachment?AENO?AbError);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bDisableLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_TRANSFER_CONTROL_LOG!,,21,0,39,5,,?DEN?DnLogID?DsControl?AENO?AbError);
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'DISABLE',19,3,21,5,);
B(B_VAROUT,,bIsError,39,2,41,4,);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If (bSetLogTransferSMTP) Then
    FP_SMTP_SET_MODE_TRANSFER_LOG(nLogID := 0,
                                  sGroupNumber_Subject := 'GRPNO=0,SUBJECTAUTO',
                                  sBodyText := 'Sent Log Files', 
								  sAttachment := 'INFO=NON,ATT=NONE', bError => bIsError);
End_if;
If (bDisableLogTransferSMTP) Then
    FP_SMTP_TRANSFER_CONTROL_LOG(nLogID := 0,
                                 sControl := 'DISABLE', bError => bIsError);
End_if;