mail Function

This function initiates a mail transaction with the server. The destination is a mailbox.

Syntax

UTL_SMTP.MAIL (
   c           IN OUT NOCOPY connection, 
   sender      IN OUT NOCOPY, 
   parameters  IN OUT NOCOPY) 
RETURN reply;
UTL_SMTP.MAIL (
   c           IN OUT NOCOPY connection,
   sender      IN OUT NOCOPY, 
   parameters  IN OUT NOCOPY);

Parameters

Table 82-11 Mail Function Parameters

Parameter	Description
c (IN NOCOPY)	The SMTP connection.
sender (IN OUT NOCOPY)	The e-mail address of the user sending the message.
parameters (IN OUT NOCOPY)	The additional parameters to MAIL command as defined in Section 6 of [RFC1869]. It should follow the format of "XXX=XXX (XXX=XXX ....)".

Usage Notes

This command does not send the message; it simply begins its preparation. It must be followed by calls to rcpt() and data() to complete the transaction. The connection to the SMTP server must be open and a helo() or ehlo() command must have already been sent.

The expected response from the server is a message beginning with status code 250.