función escalar SEND_EMAIL

La función escalar SEND_EMAIL envía un correo electrónico a uno o varios destinatarios. Esto se realiza utilizando el mandato CL SNDSMTPEMM (Enviar mensaje de correo electrónico SMTP).

Esta función presupone que el usuario que invoca esta función se ha registrado en el servidor SMTP utilizando el mandato CL ADDUSRSMTP (Añadir usuario SMTP). Si el servidor SMTP no está activo, esta función intentará iniciarlo antes de enviar el correo electrónico.

Autorización: Consulte la siguiente nota.

Leer diagrama de sintaxisOmitir diagrama de sintaxis visual SEND_EMAIL ( TO_CORREO electrónico =>  a-correo electrónico ,SUBJECT => JAAS,Cuerpo => cuerpo,ANEXO => archivo adjunto,CC_CORREO electrónico => cc-correo electrónico,BCC_CORREO electrónico => correo electrónico de copia oculta,TIPO_CUERPO => tipo de cuerpo )
El esquema es SYSTOOLS.
para enviar por correo electrónico
Cadena de caracteres que contiene una o varias direcciones de correo electrónico. Las direcciones deben ir separadas por una coma. Los espacios en blanco incluidos antes o después de cada coma se ignoran.
El número total de direcciones de correo electrónico proporcionadas con los parámetros to-email, cc-email y bcc-email no puede ser superior a 20.
asunto
Una serie de caracteres de hasta 255 caracteres de longitud que contiene el asunto del correo electrónico.
cuerpo
Una serie de caracteres de hasta 5000 caracteres de longitud que contiene el cuerpo del correo electrónico.
archivo adjunto
Cadena de caracteres que contiene hasta 10 nombres de ruta de archivos del sistema de archivos integrado que se enviarán como archivos adjuntos al correo electrónico. Cada nombre de ruta absoluta puede tener hasta 200 caracteres. Los nombres de vía de acceso deben estar separados por una coma. Los espacios en blanco incluidos antes o después de cada coma se ignoran.
Si se omite este parámetro, no se envía ningún archivo adjunto con el correo electrónico.
cc-email
Cadena de caracteres que contiene una o varias direcciones de correo electrónico que se incluirán en la lista de copias de carbón. Las direcciones deben estar separadas por una coma. Los espacios en blanco incluidos antes o después de cada coma se ignoran.
El número total de direcciones de correo electrónico proporcionadas con los parámetros to-email, cc-email y bcc-email no puede ser superior a 20.
Si se omite este parámetro, no se incluirá ninguna lista de copias para el correo electrónico.
bcc-email
Cadena de caracteres que contiene una o varias direcciones de correo electrónico que se incluirán en la lista de copia oculta. Las direcciones deben estar separadas por una coma. Los espacios en blanco incluidos antes o después de cada coma se ignoran.
El número total de direcciones de correo electrónico proporcionadas con los parámetros to-email, cc-email y bcc-email no puede ser superior a 20.
Si se omite este parámetro, no se incluirá ninguna lista de copia oculta para el correo electrónico.
tipo de cuerpo
El tipo de contenido para body. Los valores aceptados son *PLAIN, *HTML y *XML. Por defecto es *PLAIN.
El resultado de la función es un entero. Si el mandato es satisfactorio, la función devuelve un valor de 1. Si el comando devuelve un error, la función devuelve un valor de -1.

Nota

Esta función se proporciona en el esquema SYSTOOLS como ejemplo de cómo enviar un correo electrónico utilizando el mandato CL SNDSMTPEMM en una función escalar SQL. De forma similar a otras herramientas proporcionadas por Db2® for i en SYSTOOLS, el origen SQL se puede extraer y utilizar como modelo para crear funciones de ayudante similares, o para crear una versión personalizada dentro de un esquema especificado por el usuario.

Los servicios proporcionados en SYSTOOLS tienen requisitos de autorización determinados por las interfaces utilizadas para implementar el servicio. Para comprender los requisitos de autorización, extraiga el SQL para el servicio y examine la implementación.

Ejemplos

  • Enviar un correo electrónico a un usuario con un archivo adjunto.
     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');
  • Enviar un correo electrónico a varios usuarios con 2 archivos adjuntos.
     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');