ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application
HP NonStop ASAP Extension Manual—425265-004
4-7
ASAP_REGISTER_ Procedure
domain^name:domain^name^len
STRING .EXT:ref:*, INT:value
is a one to five level domain name this set of application metrics belongs to.
The entity name is the first (leftmost) level of the name. The name is of the
form <1>\<2>\<3>\<4>\<5>, where each level except the first can be any
length up to the maximum total length of 64 bytes. Domain^name^len is the
length of the domain and is a maximum of 64 bytes. This procedure
automatically appends the name of the calling process to the domain name to
create the fully qualified domain name that is passed to ASAPXMON unless
flags bit 14 is on. If flags bit 14 is not on, the domain name provided cannot
exceed four levels, and domain^name^length + process^name^length+1
cannot exceed 64 bytes.
seg^offset
INT(32) .EXT:ref:1
is the returned offset into the shared memory segment allocated to the metrics
for this domain. This value must be maintained and passed to all other ASAP
Extension procedures.
error^detail
INT .EXT:ref:1
is a detailed error, if any is returned here when this parameter is used and an
error occurs.
segment^id
INT
is the segment identifier to be used by the registration procedure in its call to
SEGMENT_ALLOCATE_. Supply this value when an application process has
previously called ALLOCATESEGMENT or SEGMENT_ALLOCATE_.
The default is 0.
–8 Max domains reached. No more domains can be registered in that CPU.
–9 Duplicate domain name found. Registration is rejected.
–10 Memory slot for this domain is already allocated to another domain.
–11 Invalid reply received from ASAPXMON.
-12 Memory address trap detected. The shared memory address returned from
ASAPXMON causes a memory trap.
Value Definition