ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-21
asap_control and asap_control_ts
Activate or deactivate ranking for the domain. Deactivation is useful in the case
of a domain that enters a dormant state for some time. ASAP sets the state of
domain to exists, and no further alerts are issued for that domain until ranking is
activated.
An application should call asap_control for a domain if the domain is not
updating its data for a time but will become active again in the future. If a
domain will never update its data again, the domain should be removed using
asap_remove.
Declaration
short asap_control (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const bool rank_enabled_ind, // IN REQUIRED
// true = rank enable, false = disable
short *ptr_error_detail = NULL // OUT OPTIONAL
// Detailed error number, if any
);
short asap_control_ts (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const bool rank_enabled_ind, // IN REQUIRED
// true = rank enable, false = disable
short *ptr_error_detail = NULL // OUT OPTIONAL
// Detailed error number, if any
);
Parameter Descriptions
void *handle
The handle returned from the call to asap_register. This parameter is required.
const bool rank_enabled_ind
Flag to enable or disable ranking; true = ranking enabled, false = ranking
disabled. This parameter is required.
short *ptr_error_detail
A detailed error code, if any. This parameter is optional. The default value is
NULL, which means no detailed error code is returned.