NAME

     immd_init, immd_end  -  Initializes  or  terminates  message
     dequeuing operations.


SYNOPSIS

     #include <imta.h>

     int immd_init(immd_t *md);

     void immd_end(immd_t md);


DESCRIPTION

     Initializes SIMS for message dequeue operations and  creates
     a  message dequeue context. imta_init() must be called prior
     to   calling   immd_init().    After   calling   immd_init()
     immd_get_() can be called to access the next queued message.

     immd_end() must ba called to dispose of  a  message  dequeue
     context.


ARGUMENTS

     md          Message dequeue context to be created.


RETURN VALUES

     immd_init() returns IMRC_OK when successful, and one of  the
     following error codes if an error occured.

     IMRC_OUT_OF_MEMORY
                 There is not  enough  memory  to  start  an  new
                 dequeue context.


ATTRIBUTES

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


SEE ALSO

     immd_get(3), imta_init(3)