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

e
EvmSrvStart(3) EvmSrvStart(3)
NAME
EvmSrvStart(), EvmSrvMessageGet() - event service functions
SYNOPSIS
#include <evm/evm.h>
EvmStatus_t EvmSrvStart(
char *
service_name ,
char *
arg_string,
EvmTransport_t *
transport,
EvmConnection_t *
connection );
EvmStatus_t EvmSrvMessageGet(
EvmConnection_t
connection ,
EvmEvent_t *
event,
char **
msg,
char **
errmsg,
EvmInt32_t *
info );
Remarks
EvmSrvMessageGet is not currently supported for general use.
Library
EVM Support Library (
libevm.so).
Parameters
service_name The name for this service. The name must be a service defined in the EVM daemon
configuration file,
.CR /etc/evmdaemon.conf .
arg_string If this operand is not NULL, it is written to the connection when the service is started.
transport Specify the type of connection to be made to the daemon. Because EVM currently supports
only local connection the daemon, transport must always be set to NULL. If this argument
is not NULL, an error occurs.
EVM does not support remote connection.
connection For EvmSrvStart()
, this is the return operand. The calling routine passes this value to
EvmConnDestroy() when it is done with the connection.
For
EvmSrvMessageGet()
, this is the service connection that is read for a message.
event If this operand is not NULL on return, it contains an EVM event returned by the service.
msg If this operand is not NULL on return, it contains a character string returned by the service.
errmsg If this operand is not NULL on return, it contains an error message character string
returned by the service.
info If this operand is not NULL on return, it contains numeric information returned by the ser-
vice.
DESCRIPTION
The
EvmSrvStart() routine creates a service connection to the EVM daemon, requesting that the ser-
vice identified as service_name be started. If the service is known to the daemon, it is started as a child
process of the daemon, and the connection is transferred to the service process. If the arg_string is not
NULL, the function then appends a newline character to it and writes it to the connection.
The EvmSrvMessageGet() routine reads a single EVM service protocol message from the service con-
nection identified by connection and returns it to the caller. The message may be a procedural protocol
message, indicating that the service has started or terminated, or it may carry data. Procedural messages
are handled by the API function. Data messages may be any one of the following:
• An EVM event returned to the caller in event
• A character string returned to the caller in msg
• An error character string returned to the caller in errmsg
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 399