Manual de consulta

DTW_SENDMAIL


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:
  • Nombre <usuario@dominio>
  • <usuario@dominio>
  • usuario@dominio
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:
  • Nombre <usuario@dominio>
  • <usuario@dominio>
  • usuario@dominio
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:
  • Nombre <usuario@dominio>
  • <usuario@dominio>
  • usuario@dominio
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:

  • imagen/jpeg
  • imagen/gif
  • audio/básico
  • aplicación/flujo de octetos (general)

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

  1. Puede utilizar la variable de configuración opcional, DTW_SMTP_SERVER, para especificar el servidor SMTP a utilizar para transmitir mensajes de correo electrónico. El valor de este parámetro puede ser un nombre de sistema principal o una dirección IP. Cuando esta variable no esté definida, Net.Data utilizará el sistema principal local como servidor SMTP. Consulte el capítulo sobre configuración de la Net.Data Guía de administración y programación para el sistema operativo para obtener más información sobre esta variable. DTW_SMTP_SERVER se ignora en OS/390.
  2. Usuarios de OS/2, Windows NT y UNIX: Los servidores del Protocolo simple de transferencia de correo estándar (SMTP) sólo aceptan datos de 7 bits, como los caracteres ASCII de EE.UU. Si el mensaje tiene caracteres de 8 bits, es recomendable especificar un servidor de Protocolo simple de transferencia de correo ampliado (ESMTP); los servidores ESMTP aceptan caracteres de 8 bits. Net.Data no codifica los datos de 8 bits en datos de 7 bits. Si no tiene acceso a un servidor ESMTP, elimine todos los caracteres de 8 bits del mensaje de correo electrónico.

    Los usuarios de Net.Data para OS/390 no necesitan modificar mensajes de correo electrónico para servidores SMTP.

  3. Soporte del juego de caracteres:
  4. La lista siguiente describe las condiciones bajo las que Net.Data no envía un mensaje de correo electrónico:
  5. El parámetro adjuntos no es válido en OS/390.

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).


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]