NAME

     imme_start_envelope - Begins the enqueue of one message.


SYNOPSIS

     #include <imta.h>

     int imme_start_envelope(imme_t me, const char  *from);


DESCRIPTION

     imme_start_envelope() must be  called  to  start  a  message
     enqueue.    Nothing  can  be  written  to  a  message  being
     enqueued, prior to calling imme_start_envelope().  The  from
     argument  specifies  the envelope From: address to associate
     with the message being enqueued.  It is a mandatory  parame-
     ter  and  it  should  conform  to  RFC  822.  After  calling
     imme_start_envelope(), imme_add_recipient() should be called
     to  specify  all  message  recipients  (To:,  Cc:,  and Bcc:
     addresses).


RETURN VALUES

     imme_start_envelope() returns IMRC_OK when successful.  Oth-
     erwise, one of the following error codes is returned:

     IMRC_BAD_CONTEXT
                 The enqueue context me has not been  initialized
                 or  has  been  corrupted.  Make sure imme_init()
                 has been previously called.

     IMRC_NO_MAILFROM
                 from is null.  Cannot create an envelope without
                 an originator.  Envelope not started.

     IMRC_INVALID_ADDRESS
                 from   is   a   non-rfc822-compliant    address.
                 Envelope not started


ATTRIBUTES

               _______________________________________
              |   Attribute Type   |  Attribute Value|
              |____________________|_________________|
              | Architecture       |  sparc, x86     |
              |____________________|_________________|
              | Availability       |  SUNWimsdk      |
              |____________________|_________________|
              | MT-Level           |  MT-Safe        |
              |____________________|_________________|
              | Interface Stability|  Stable         |
              |____________________|_________________|


SEE ALSO

     imme_init(3),     imta_error(3),      imme_add_recipient(3),
     immd_read_text(3)