HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

e
EvmConnControl(3) EvmConnControl(3)
EvmCONN_POST_NONBLOCK_SET
Controls the behavior of the calling process if an attempt to post an event would
overflow the connection’s send buffer. If this option is set to
EvmFALSE (the default
state when the connection is established), the process blocks as necessary to synchron-
ize message transfer to the EVM daemon.
If it is set to
EvmTRUE, EvmEventPost()
returns EvmERROR_QUEUED
if an
event cannot be sent fully without blocking. In addition, the process must invoke
EvmConnFlush()
a short time later, to avoid unsent messages accumulating in
memory. Further calls to
EvmEventPost() also flush the queue. Refer to the
EvmConnFlush(3) manpage for more details.
This option cannot be used for any connection type other than a posting connection
with a response mode of
EvmRESPONSE_IGNORE
. This option is provided for criti-
cal high-performance processes which must post a large number of events in a very
short time. This option is not suitable for general use.
The arg argument is an
EvmBoolean_t value. A value of
EvmFALSE allows the process to block if
necessary. A value of
EvmTRUE prevents blocking and enables message queuing.
RETURN VALUE
EvmERROR_NONE The operation completed without error.
EvmERROR_INVALID_ARGUMENT
One of the arguments to the function is invalid.
EvmERROR_INVALID_VALUE
A value in a structure member is invalid.
EvmERROR_NO_MEMORY
An operation failed because an attempt to acquire heap memory
failed.
EvmERROR_RESOURCE
An unexpected error occurred while attempting to acquire or control
a system resource.
EvmERROR_SIGNAL The current operation was interrupted by receipt of a signal.
ERRORS
The value of
errno is not set.
SEE ALSO
Functions
connect(2), select(2).
Routines
EvmConnCheck(3), EvmConnCreate(3), EvmConnSubscribe(3), EvmConnWait(3).
Event Management
EVM(5).
Event Connection
EvmConnection(5).
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 377