ASAP 1.1 Hybrid Manual

HP NonStop ASAP Hybrid Manual 529729-004
Page 4-24
The ASAP OEM state to assign for this domain. This value can be from
ASAP_STATE_EXISTS (object exists) through ASAP_STATE_DOWN (object is down).
For ASAP_STATE values, see the asapx.h header file. 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.
Return Values
ASAP_ERROR_NONE (0)
No error. Operation was successful.
ASAP_ERROR_INVALID_PARAM (-101)
A parameter was invalid. If specified, *ptr_error_detail contains the incorrect
parameter number (first param = 1).
ASAP_ERROR_REMOVED (-111)
The domain has been removed. Once cleanup occurs, the domain can be
reregistered.
ASAP_ERROR_HOST_DOMAIN (-112)
There is a problem with this domain on the NonStop server. Updates continue to
occur locally on the Linux system and are sent to the server. However, the server
might not be able to update or display this data. *ptr_error_detail contains the
NonStop server error number.
ASAP_ERROR_MUTEX (applies to asap_opstate_ts only) (-113)
No mutex was allocated for this domain, or there was an error accessing the
mutex. The operation is not performed. To set the operational state of the
domain, the application must use the standard asap_opstate call.
Differences from the NonStop ASAPX API
The operational text parameter is supplied as a standard C null-terminated
string, and the operational text length parameter (optext^len) has been
eliminated.