ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application

HP NonStop ASAP Extension Manual—425265-004

4-20

Controlling the Ranking of a Domain

You can turn off ranking for a domain to instruct ASAPX to return ASAP State 1 for all

metrics within the domain. The domain then appears gray on the ASAP graph displays.

You can control the ranking of a domain through the ASAP RANK command and

through programmatic use of the ASAP_CONTROL_ procedure.

ASAP_CONTROL_ Procedure

Use the ASAP_CONTROL_ procedure to enable and disable ranking for a domain.

error

INT

indicates the outcome of the registration call. It returns one of these values:

seg^offset

INT(32)

is the offset into the shared memory segment allocated to the metrics for this

domain. This was initially returned to the caller in its call to

ASAP_REGISTER_.

error^detail

INT .EXT:ref:1

is returned here when this parameter is used and an error occurs.

error := ASAP_CONTROL_ ( seg^offset !i

[,error^detail] !o

, flags !i

)

Error Description

0 No error; removal was successful.

–1 The calling process is not named.

–2 Parameter missing or in error. error^detail contains the parameter

number.

–3 File-system error. error^detail contains the file-system error number.

–4 Checksum error. Shared memory is corrupted.

–5 This domain was not found in the memory location specified by seg^offset.

–6 Memory address trap detected. The supplied shared memory address

causes a memory trap.