FP_SMTP_SET_CONNECTION

此FP指令将根据指定参数定义用于连接CPU中指定的SMTP客户端的服务器设置。

参数

输入

sAccount(STRING)

使用名称、地址、端口号和身份验证方法设置账户数据。

• 源名（可选参数）

  关键字： NAME

• 源电子邮件地址（须输入参数）

  关键字： FROM

  语法： 'FROM='

• IP地址或主机名称 （须输入参数）。

  • IP地址

    对于IP地址，请在开头指定关键字IPv4或IPv6。

    IPv4的语法：例如'IPv4=111.122.133.144'

    IPv6的语法：例如'IPv6=1111:122:2:1555:0:0:1888'

    请注意，对于IPv4地址有范围限制。当使用指令指定了无效的IP地址时，将不会出现任何运算错误，但输出bError将设置为TRUE。

  • 主机名

    关键字： HOST

    语法：'HOST=SMTP.pidsx.com'

• 端口号（可选参数）

  关键字： 'PORT'

  语法： 'PORT=xxxxx'（默认：25）

  范围：1–65535

• SSL3/TSL1验证（可选参数）. 指定是否使用SSL3/TSL1验证。

  关键字：

  • SSL：使用SSL3/TLS1

  • NON：不使用SSL3/TLS1（默认）

示例：

1. 将FP7_001设置为源名、将“pana@pana.com”设置为源电子邮地址、将102.244.2.110设置为IP地址，并使用端口25，进行SSL3/TLS1身份验证：'NAME=FP7_001,FROM=pana@pana.com,IPv4=192.255.2.10,PORT=25,SSL'

2. 保持源名不变，将“sunx@sunx.com”设置为源电子邮件地址、将1222::a8dd:0:0:6666设置为IP地址，使用端口100，进行SSL3/TLS1身份验证：',FROM=sunx@sunx.com,IPv6=1111:1222::a8dd:0:0:6666,PORT=100,SSL'

3. 将FP7_002设置为源名，将“pewsunx@pewsunx.com”设置为源电子邮件地址，将“SMTPmailserver.com”设置为主机名，使用端口1000，不进行身份验证：'NAME=FP7_002,FROM=pewsunx@pewsunx.com,HOST=SMTPmailserver.com,PORT=1000,NON'

4. 将FP7_002设置为源名、将“pewsunx@pewsunx.com”设置为源电子邮件名称、将“SMTPmailserver.com”设置为主机名。请勿更改端口号和身份验证的设置：'NAME=FP7_002,FROM=pewsunx@pewsunx.com,HOST=SMTPmailserver.com'

sLogin(STRING)

设置登录数据

• SMTP验证方法（须输入关键字）

  关键字：

  • CRAM：CRAM-MD5已使用

  • PLAIN1：PLAIN1(ID/PASS)已使用

  • PLAIN2：PLAIN2(ID/PASS)已使用

  • LOGIN：LOGIN已使用

• 账户（最多32个字符）

  关键字： ACCOUNT

  语法： 'ACCOUNT=xxx' （默认：root）。使用'ACCOUNT='删除账户。

• 密码（最多32个字符，大小写字符均可使用）

  关键字： PASS

  语法： 'PASS=xxx' （默认：root）。使用'PASS='来删除密码。

对于此参数，还有两个额外的关键字可用：

• NOUSE：SMTP身份验证方法的设置将被忽略。

• 保留：保留当前登录设置。

示例：

1. 将CRAM-MD5设置为账户“sunx”的SMTP身份验证方法，密码为“control”：'CRAM,ACCOUNT=sunx,PASS=control'

2. 将CRAM-MD5设置为账户“root”的SMTP身份验证方法，并删除密码：'CRAM,ACCOUNT=root,PASS='

3. 将PLAIN1设置为SMTP身份验证方法，删除账户名称，使用密码“SUNX”：'PLAIN1,ACCOUNT=,PASS=SUNX'

4. 将PLAIN2设置为SMTP身份验证方法，删除账户名称和密码：'PLAIN2,ACCOUNT=,PASS='

5. 将LOGIN设置为账户“panasonic”的SMTP身份验证方法，并保留已设置的密码：'PLAIN2,ACCOUNT=panasonic'

6. 将CRAM-MD5设置为已指定的账户名称的SMTP身份验证方法，并设置密码“SUNX”：'CRAM,,PASS=SUNX'

7. 请勿使用SMTP身份验证方法、账户，请勿更改密码：'NOUSE'

8. 保留SMTP身份验证方法、账户和密码：'KEEP'

sCommunication(STRING)

根据需要设置可选通信参数。请注意，默认电子邮件语言设置为日语。

• 最大电子邮件大小

  关键字： MAILSIZE

  语法： 'MAILSIZE=xxx'（默认：100）

  范围：1–10240KB

• 连接超时

  关键字： TOUT

  语法： 'TOUT=xxx'（默认：60秒）

  范围：30–300秒

• 重试次数

  关键字： RTRY

  语法： 'RTRY=x'（默认：3次）

  范围：0–3

• 重试间隔

  关键字： RTTM

  语法： 'RTTM=xxxxx'（默认：600秒）

  范围：10-86400秒

  可以10秒为单位指定数值。将向下舍入到整十数。

  示例：指定38秒时，将设置为30秒。

• 用于电子邮件主题和文本的语言。

  关键字：

  • JPN：日语（默认）

  • ENG：英语

对于此参数，还有两个额外的关键字可用：

• INITIAL：重置连接超时、重试次数和重试间隔默认设置。

• KEEP：保留当前通信设置。

示例：

1. 设置最大电子邮件大小：1000KB，连接超时：30秒，重试次数：2次，重试间隔：500秒，电子邮件语言：日语：'MAILSIZE=1000,TOUT=30,RTRY=2,RTTM=500,JPN'

2. 设置最大电子邮件大小：10000KB，连接超时：270秒，不可重试，重试间隔：4900秒，电子邮件语言：英语：'MAILSIZE=10000,TOUT=270,RTRY=0,RTTM=4900,ENG'

3. 设置最大电子邮件大小：500KB，连接超时：30秒，重试次数：3次，重试间隔：200秒，电子邮件语言：请勿更改：'MAILSIZE=500,TOUT=30,RTRY=3,RTTM=200'

4. 设置最大电子邮件大小：5000KB，连接超时：请勿更改，重试次数：5次，重试间隔：3000秒，电子邮件语言：英语：'MAILSIZE=5000,,RTRY=5,RTTM=3000,ENG'

5. 重置为默认设置（最大电子邮件大小：100KB，连接超时：60秒，重试次数：3次，重试间隔：600秒，默认电子邮件语言：日语）：'INITIAL'

6. 保留所有当前设置：'KEEP'

输出

bError (BOOL)

在以下情况下将变为TRUE：

• 如果超过连接超时

• 如果 IP 地址无效

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

标注

• 通过逗号分隔所有关键字输入。例如：'NAME=abcd,FROM=sender@server.com'

• 字符串数据的字符数不得超过256。

• 此指令不可用于中断程序。

• 大小写字符均可用于指定关键字。但是，主题、电子邮件文本和附件的文件名区分大小写。

• 执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。

• 仅当指定传输设置的传输请求标志或指定的nLogID编号为FALSE时，才能执行该指令。当传输请求标志为TRUE时，将发生运算错误。

• 成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。

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

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

• 如果为参数指定的值超出允许的范围。

• 如果指定相同关键字超过一次

• 如果指定传输设置的电子邮件传输请求标志为“TRUE：请求传输”。

• 如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。

• 如果指令是在中断程序中执行的。

• 如果字符串数据的字符数超过256。

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

• 如果为参数指定的值超出允许的范围。

• 如果指定相同关键字超过一次

• 如果指定传输设置的电子邮件传输请求标志为“TRUE：请求传输”。

• 如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。

• 如果指令是在中断程序中执行的。

• 如果字符串数据的字符数超过256。

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

• 如果指令是通过错误的IP地址执行的，则sys_iEthernetConnectionErrorCode设置为“1：指定了错误的IP地址”

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