NAME

     imme_write_header - Write a  message  header  to  a  message
     being enqueued.


SYNOPSIS

     #include <imta.h>

     int imme_write_header(imme_t me, imhdr_t hdr);


DESCRIPTION

     imme_write_header() writes the message header object  refer-
     enced  by  hdr  to a message being enqueued with the enqueue
     context referenced by me.

     The header object hdr may be created with the message header
     API,  e.g.   imhdr_add_line(), or it may be read from a mes-
     sage being dequeued by calling immd_read_header().


RETURN VALUES

     imme_write_header() returns IMRC_OK when successful,  and  a
     negative error code otherwise.

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

     IMRC_NO_RECIPIENT
                 adr is nil.

     In  particular,  imme_write_header()  will  fail  if  called
     before  any recipient of the message have been specified.  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 | | |

     imta-test-rewrite(1),   imme_init(3),   immd_read_header(3),
     imme_add_headerLine(3)        |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |
              |                    |                 |