EvmEventCreate(3)					     Library Functions Manual						 EvmEventCreate(3)

NAME

       EvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup() - create and destroy events

SYNOPSIS

   Notes
       Brackets [ ] are not part of the syntax; they denote optional parameters.

   Library
       EVM Support Library

   Parameters
       event	     The event to be created, copied, or destroyed.

       item_id	     The  identifier  for  the Event Data Item to be set.  See the EvmItemSet(3) manpage for possible values for this operand, and
		     the data contained by the data item.

       item_value    The value to be stored in the associated item indicated by item_id.

       dupev	     The return location where the duplicate (new) event is stored.

DESCRIPTION

       The routine creates an empty event.  The newly created event is returned in the event reference argument.

       The routine creates an event and adds the supplied items in a single call.  The item list is terminated by an instance of the item_id oper-
       and set to The newly created event is returned in the event reference argument.

       The  routine destroys a previously created event, freeing its memory.  This function must be used if it is necessary to destroy an event to
       ensure that all associated memory is freed.

       The routine creates a copy of the supplied event and returns the new event in the dupev reference argument.

   Notes
       To avoid memory leakage, all structures that are supplied to the caller from API routines must be freed with the appropriate EVM  API  free
       routine.

RETURN VALUE

       The operation completed without error.

       One of the arguments to the function is invalid.

       A value in a structure member is invalid.

       An operation failed because an attempt to acquire heap memory failed.

ERRORS

       The value of is not set.

SEE ALSO

   Commands
       evmpost(1).

   Routines
       EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3) EvmEventWrite(3).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

																 EvmEventCreate(3)