ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application
HP NonStop ASAP Extension Manual—425265-004
4-22
Operational Status and State
Operational Status and State
Application records contain a 15-byte text field used to indicate the operational status
and state of the domain. ASAPX sets this to Up, Down, Error, or Removed. The
application can set the status text and associated state directly with a new API
procedure ASAP_OPSTATE_.
ASAP_OPSTATE_
The ASAP_OPSTATE_ procedure sets the Status text and operational state fields for a
registered ASAP application domain.
error
INT
indicates the outcome of the procedure call:
error^Detail
INT .EXT:ref:*
contains detailed error information, if any.
OpText:OpText^Len
STRING .EXT:ref:*, INT:value
contains 1 to 15 alphanumeric characters representing the current operational
status of the domain. This text is displayed in the Status field for the domain.
error := ASAP_OPSTATE_ ( seg^offset !i
[,error^detail] !o
[,OpText:OpText^Len] !i
[,OpState] !i
) EXTENSIBLE;
Error Description
–1 Calling process is not named.
–2 Parameter error. error^detail contains the parameter in error unless it
is itself in error.
–3 File-system error. error^detail contains the file-system error number.
–4 Memory-not-mine error. Memory slot is now owned by another domain or is
corrupt.
–5 Checksum error. Memory is corrupted.