开始更改

SEND_EMAIL 标量函数

在线编辑

SEND_EMAIL 标量函数向一个或多个收件人发送电子邮件。 这是通过使用 SNDSMTPEMM (发送 SMTP 电子邮件消息) CL 命令完成的。

此函数假定调用此函数的用户已使用 ADDUSRSMTP (添加用户 SMTP) CL 命令向 SMTP 服务器注册。 如果 SMTP 服务器未处于活动状态，那么此功能将尝试在发送电子邮件之前将其启动。

授权: 请参阅下面的注释。

读取语法图跳过可视语法图 SEND_EMAIL ( 发送电子邮件 =>  收件人-电子邮件 ,主题 => 主题,BODY => body,附件 => 附件,CC_EMAIL => 抄送-电子邮件,BCC_EMAIL => bcc-电子邮件,主体类型 => 体型 )
模式为 SYSTOOLS。
收件人-电子邮件
包含一个开始更改或多个结束更改电子邮件地址的字符串。 开始更改地址必须用逗号分隔。 每个逗号前后的空格将被忽略。结束更改
开始更改The total number of email addresses provided with the 发至邮箱, 抄送电子邮件, and 密送电子邮件 parameters cannot exceed 20.结束更改
主题
最长为 255 个字符的字符串，其中包含电子邮件的主题。
主体
包含电子邮件正文的最长 5000 个字符的字符串。
附件
字符串，包含 开始更改 最多 10 个结束更改 集成文件系统文件的路径名，这些文件将作为附件发送到电子邮件。 开始更改每个绝对路径名最长可包含 200 个字符。 路径名必须以逗号分隔。 每个逗号前后的空格将被忽略。结束更改
如果省略此参数，那么不会随电子邮件一起发送任何附件。
开始更改抄送电子邮件结束更改
开始更改包含一个或多个电子邮件地址的字符串，这些地址将包含在碳拷贝列表中。 地址必须以逗号分隔。 每个逗号前后的空格将被忽略。结束更改
开始更改The total number of email addresses provided with the 发至邮箱, 抄送电子邮件, and 密送电子邮件 parameters cannot exceed 20.结束更改
开始更改如果省略此参数，电子邮件将不包含碳拷贝列表。结束更改
开始更改密送电子邮件结束更改
开始更改一个字符串，包含一个或多个要列入盲碳拷贝列表的电子邮件地址。 地址必须以逗号分隔。 每个逗号前后的空格将被忽略结束更改
开始更改The total number of email addresses provided with the 发至邮箱, 抄送电子邮件, and 密送电子邮件 parameters cannot exceed 20.结束更改
开始更改如果省略此参数，电子邮件将不包含盲碳拷贝列表。结束更改
开始更改体型结束更改
开始更改The content type for 机构. 可接受的值有 *PLAIN、*HTML 和 *XML。 默认值为 *PLAIN结束更改
函数的结果为整数。 如果该命令成功，那么该函数将返回值 1。 如果命令返回错误，函数将返回 -1 值。

注

此函数在 SYSTOOLS 模式中提供，作为如何在 SQL 标量函数中使用 SNDSMTPEMM CL 命令发送电子邮件的示例。 与 SYSTOOLS 中提供的其他 Db2® for i 工具类似，可以抽取 SQL 源并将其用作用于构建类似帮助程序函数的模型，或者在用户指定的模式中创建定制版本。

SYSTOOLS 中提供的服务具有由用于实现服务的接口确定的授权需求。 要了解权限需求，请抽取服务的 SQL 并检查实现。

示例

  • 向具有附件的用户发送电子邮件。
     VALUES SYSTOOLS.SEND_EMAIL(TO_EMAIL   => 'someuser@gmail.com', 
                            SUBJECT    => 'Status for last week', 
                            BODY       => 'Attached is the status information for last week.', 
                            ATTACHMENT => '/home/myuser/status.log');
  • 向具有 2 附件的多个用户发送电子邮件。
     VALUES SYSTOOLS.SEND_EMAIL(TO_EMAIL   => 'someuser@gmail.com, mymanager@xyz.com',
                            CC_EMAIL   => 'anotheruser@gmail.com',
                            SUBJECT    => 'Status and future plans', 
                            BODY       => 'Attached is the status for last week and the future plan.', 
                            ATTACHMENT => '/home/myuser/status.log, /home/myuser/plan.docx');
结束更改