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)