|
|
IBM Plunges Into ?Business Event Management,? Helping Define Field
|
|
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)
