NAME

     imme_write_text - Write text to a message being enqueued.


SYNOPSIS

     #include <imta.h>

     int imme_write_text(imme_t me, const char  *text);


DESCRIPTION

     imme_write_text() writes the NULL-terminated  string  refer-
     enced   text  in  the  body  of  a  message  being  enqueued
     corresponding to the enqueue context me . It must be  called
     only after has been called.

     imme_write_text() does not append line  a  terminator  (CRLF
     for  SMTP)  to the given string, text.  It is left to caller
     to include line terminators,  where  appropriate,  in  their
     text.  This allows a single call to output multiple lines of
     text to the message body.  If  this  terminator  is  omitted
     then,  in  the  message  being composed, the subsequent line
     will be appended directly to the end the given text  lacking
     a terminator.


RETURN VALUES

     imme_write_text() returns IMRC_OK when successful.  And oth-
     erwise:

     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_ENVELOPE
                 The message envelope has not been created.  Call
                 imme_start_envelope() to create it.

     A textual explanation of the failure can be obtained by cal-
     ling imta_error() immediately afterwards.


ATTRIBUTES

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


SEE ALSO

     imme_init(3), immd_write_header(3)