ARGetCacheEvent
Description
Retrieves the list of events that occurred in the AR System server cache and the number of server caches, and indicates when administrative operations become public. You can direct this API call to either return the results immediately or when the next event occurs. This call is useful for detecting cache events in production cache mode.
A server cache event occurs when you perform an administrative operation (for example, importing a definition file, creating a schema, creating workflow, or creating other AR System objects). When the operation is performed, AR System creates a new copy of the server cache (administrative cache) and modifies it. After a brief delay, the old cache is released and the new cache is made public, so that newly created objects are available to users. If multiple operations are performed simultaneously, AR System creates multiple copies of the administrative cache.
This call differs from other API calls in that it has a default 8 hour timeout.
Privileges
The system returns data based on the access privileges of the user that you specify for the control parameter.
Synopsis
int ARGetCacheEvent(
ARControlStruct *control,
ARInternalIdList *eventIdList,
unsigned int returnOption,
ARInternalIdList *eventIdOccuredList,
unsigned int *cacheCount,
ARStatusList *status)
Input arguments
control
The control record for the operation. It contains information about the user requesting the operation, where that operation is to be performed, and which session is used to perform it. The user and server fields are required.
eventIdList
A list of types of events to return if they have occurred:
returnOption
Controls whether the call returns immediately or waits for the next event to occur:
In the case of AR_GCE_OPTION_NONE, the server immediately returns with the list of events that are currently true.
In the case of AR_GCE_OPTION_NEXT, the server only returns when one of the events in the list becomes true. At that time, the list of returned events is the one that caused the call to return.
Return values
eventIdOccuredList
The list of types of events that have occurred. The possible events are:
cacheCount
The number of server caches. The call always returns the current number of copies of the cache in memory at the time that it returns.
status
A list of zero or more notes, warnings, or errors generated from a call to this function. For a description of all possible values, see Error-checking.