ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual – 529729-004
Page 4-23
asap_opstate and asap_opstate_ts
Set the operational state for the domain, independent of the state of any of the
domain's data items. Calling applications can use these procedures to explicitly
specify the state of a given domain and associate a textual description with that
state.
If asap_opstate is called for a given domain, the state specified overrides any
state calculated by ASAP while analyzing the domain’s metric values.
Declaration
short asap_opstate (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const char *ptr_status_text, // IN REQUIRED
// Operational status to display
const short status_state, // IN REQUIRED
// Operational state; a valid ASAP_STATE
short *ptr_error_detail = NULL // OUT OPTIONAL
// Detailed error number, if any
);
short asap_opstate_ts (
void *handle, // IN REQUIRED
// Shared memory handle for this domain
const char *ptr_status_text, // IN REQUIRED
// Operational status to display
const short status_state, // IN REQUIRED
// Operational state; a valid ASAP_STATE
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 char *ptr_status_text
Null-terminated character string containing the status text to set. This parameter
is displayed as the operational status of the domain, overriding any state derived
from the domain's data item values. This string can be up to
ASAP_MAX_STATUS_TEXT_LENGTH bytes in length, not including the null
terminator, must not be blank, and can contain only ASCII-printable text. This
parameter is required.
const short status_state