AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Transmite y crea dinámicamente mensajes de correo electrónico.
Formato
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN, Copia IN, ConCopiaOculta IN, ResponderA IN, Organización IN, Adjuntos IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN, Copia IN, ConCopiaOculta IN, ResponderA IN, Organización IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN, Copia IN, ConCopiaOculta IN, ResponderA IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN, Copia IN, ConCopiaOculta IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN, Copia IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN, Asunto IN)
@DTW_SENDMAIL(Remitente IN, Destinatario IN, Mensaje IN)
Parámetros
Tabla 49. Parámetros de DTW_SENDMAIL
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | remitente | IN | Variable o serie literal que especifica la dirección del autor.
Este parámetro es obligatorio. Los formatos válidos son:
|
serie | destinatario | IN | Variable o serie literal que especifica las direcciones de correo
electrónico a las que se enviará este mensaje. Este valor puede
contener varios destinatarios, separados por una coma (,). Este
parámetro es obligatorio. Los formatos de destinatario válidos
son:
|
serie | mensaje | IN | Variable o serie literal que contiene el texto del mensaje de correo electrónico. Este parámetro es obligatorio. |
serie | asunto | IN | Variable o serie literal que contiene el texto de la línea de asunto. Es un parámetro opcional. Debe especificar una serie nula ("") para especificar parámetros adicionales. |
serie | Copia | IN | Variable o serie literal que contiene las direcciones de correo electrónico o los nombres y direcciones de correo electrónico de destinatarios adicionales. Este valor puede contener varios destinatarios adicionales separados por una coma (,). Consulte el parámetro Destinatario para ver cuales son los formatos de destinatario válidos. Es un parámetro opcional. Debe especificar una serie nula ("") para especificar parámetros adicionales. |
serie | ConCopiaOculta | IN | Variable o serie literal que contiene las direcciones de correo electrónico o los nombres y direcciones de correo electrónico de destinatarios adicionales, pero los destinatarios no aparecen en la cabecera del mensaje de correo electrónico. Este valor puede contener varios destinatarios adicionales separados por una coma (,). Consulte el parámetro Destinatario para ver cuales son los formatos de destinatario válidos. Es un parámetro opcional. Debe especificar una serie nula ("") para especificar parámetros adicionales. |
serie | ResponderA | IN | Variable o serie literal que contiene las direcciones de correo
electrónico a las que deberían enviarse las respuestas a este mensaje.
Es un parámetro opcional. Debe especificar una serie nula ("") para
especificar parámetros adicionales. Los formatos ResponderA
válidos son:
|
serie | Organización | IN | Variable o serie literal que contiene el nombre de organización del remitente. Es un parámetro opcional. |
serie | Adjuntos | IN | Variable o serie literal que especifica las vías de acceso relativas a
los archivos que han de enviarse. Este valor puede contener varios
archivos, separados por una coma, pero no puede contener una serie de rangos
(..). Estos archivos se buscarán en el orden de los
directorios listados en la variable de configuración DTW_ATTACHMENT_PATH,que
está establecida en el archivo de inicialización de Net.Data.
Pueden enviarse los siguientes tipos de contenido como adjuntos:
|
Códigos de retorno
Tabla 50. Códigos de retorno de DTW_SENDMAIL
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1001 | Un parámetro de entrada contenía un valor NULL. |
1002 | Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
7000 | Net.Data no puede conectarse al servidor SMTP especificado. |
7001 | Se ha producido un error SMTP mientras Net.Data intentaba transmitir el mensaje de correo electrónico al servidor SMTP especificado. |
7002 | El servidor SMTP especificado no da soporte a ESMTP (Protocolo simple de transferencia de correo ampliado). |
Notas de utilización
Los usuarios de Net.Data para OS/390 no necesitan modificar mensajes de correo electrónico para servidores SMTP.
Tabla 51. Juegos de caracteres a los que da soporte Net.Data
Entorno nacional | Juego de caracteres | Página de códigos OS/2 o UNIX | Página de códigos Windows NT |
---|---|---|---|
Estados Unidos, Europa occidental | "iso-8859-1" | 819 | 1252 |
Japón | "x-sjis" | 943 | 932 |
Chino (simplificado) | "gb2312" | 1381 | 936 |
Corea | "euc-kr" | 970 | 949 |
Chino (tradicional) | "big5" | 950 | 950 |
Ejemplos
Ejemplo 1: La llamada de función que crea y envía un mensaje de correo electrónico simple.
@DTW_SENDMAIL("<ibmuser1@ibm.com>", "<ibmuser2@ibm.com>","There is a meeting at 9:30.", "Status meeting")
La función DTW_SENDMAIL envía un mensaje de correo electrónico con la información siguiente:
Date: Mon, 3 Apr 1998 09:54:33 PST To: <ibmuser2@ibm.com> From: <ibmuser1@ibm.com> Subject: Status meeting There is a meeting at 9:30.
La información para Fecha se interpreta utilizando las funciones de fecha y hora del sistema y se formatea en un formato de datos específico de SMTP.
Ejemplo 2: Llamada de función que crea y envía un mensaje de correo electrónico con varios destinatarios, copia y destinatarios con copia oculta y el nombre de la empresa.
@DTW_SENDMAIL("IBM User 1 <ibmuser1@ibm.com>", "IBM User 2 <ibmuser2@ibm.com>, IBM User 3 <ibmuser3@ibm.com>, IBM User 4 <ibmuser4@ibm.com>", "There is a meeting at 9:30.", "Status meeting", "IBM User 5 <ibmuser5@ibm.com>", "IBM User 6 <ibmuser6@ibm.com", "meeting@ibm.com", "IBM")
La función DTW_SENDMAIL envía un mensaje de correo electrónico con la información siguiente:
Date: Mon, 3 Apr 1998 09:54:33 PST To: IBM User 2 <ibmuser2@ibm.com>, IBM User 3 <ibmuser3@ibm.com>, IBM User 4 <ibmuser4@ibm.com> CC: IBM User 5 <ibmuser5@ibm.com> BCC: IBM User 6 <ibmuser6@ibm.com> From: IBM User 1 <ibmuser1@ibm.com> ReplyTo: meeting@ibm.com Organzation: IBM Subject: Status meeting There is a meeting at 9:30.
Ejemplo 3: Macro que crea y envía un mensaje de correo electrónico a través de una interfaz de formulario de Web
%HTML(start) { <HTML> <body> <h1>Net.Data E-Mail Example</h1> <form method="post" action="sendemail"> <p>To:<br /><input name="recipient" /></p> <p>Subject:<br /><input name="subject" /></p> <p>Message:<br /><textarea name=message rows="20" cols="40"> </textarea></p> <p><input type="submit" value="Send E-mail"></p> </form> </body> </HTML> %} %HTML(sendemail) { <HTML> <body> <h1>Net.Data E-Mail Example</h1> @DTW_SENDMAIL("Net.Data E-mail Service <netdata@us.ibm.com>", recipient, message, subject) <p>E-mail has been sent out.</p> </body> </HTML> %}
Esta macro envía un mensaje de correo electrónico a través de una interfaz de formulario de Web. La sección de inicio de HTML visualiza un formulario en el que puede escribirse un mensaje, un asunto y la dirección de correo electrónico del destinatario. Cuando el usuario pulsa el botón de Enviar correo electrónico (e-mail), el mensaje se envía a los destinatarios especificados en la sección HTML(sendemail). Esta sección llama a DTW_SENDMAIL y utiliza los parámetros que se han obtenido del formulario de la Web para determinar el contenido del mensaje de correo electrónico, así como el remitente y los destinatarios. Una vez se han enviado los mensajes de correo electrónico, se visualiza un aviso de confirmación.
Ejemplo 4: Macro que utiliza una consulta de SQL para determinar la lista de destinatarios
%Function(DTW_SQL) mailing_list(IN message) { SELECT EMAIL_ADDRESS FROM CUSTOMERS WHERE STATE='CA' %REPORT { Sending product information to our customers in California...<p> %ROW { @DTW_SENDMAIL("John Doe Corp. <john.doe@doe.com>", V1, message, "New Product Release") E-mail sent out to customer $(V1).<br /> %} %} %}
Esta macro envía un mensaje de correo electrónico automatizado a un grupo de clientes especificado que determina el resultado de una consulta de SQL a partir de la base de datos del cliente. La consulta de SQL también recupera las direcciones de correo electrónico de los clientes. El contenido del mensaje de correo electrónico lo determina el valor del mensaje y puede ser estático o dinámico (por ejemplo, puede utilizar otra consulta de SQL para especificar dinámicamente el número de versión del producto o los precios de diversas ofertas).