ASAP 2.7 Extension Manual

Introducing the ASAP Extension
HP NonStop ASAP Extension Manual—425265-004
1-4
ASAP Extension Architecture
How applications use ASAPX:
1. Applications call the ASAP_REGISTER_ API procedure to register with ASAP.
2. The ASAP_REGISTER_API procedure communicates with the ASAPXMON
process in the processor where the application resides to register and obtain the
shared memory offset for the application domain.
3. The applications call one of the API update procedures to update their statistics
directly within shared memory.
4. At the ASAP-defined statistics interval, the ASAPXSGP process prompts each
ASAPXMON process for the domain metrics from that processor.
5. ASAPXSGP or the ASAPXMON processes forward the statistics to the ASAP
collector process on the node.
The ASAP Extension has seven main components that reside in the subvolume where
ASAPX is installed, usually $SYSTEM.SYSTEM:
The ASAPX Installer places two additional files in the subvolume where ASAPX is
installed:
Component Description
ASAPX The ASAPX Conversational Interface (CI). ASAPX supports ASAPX-
specific commands.
ASAPXDLL The ASAPX procedure library as a dynamic link library. HP recommends
use of the ASAPXDLL library whenever possible.
ASAPXLIB The ASAPX procedure library. ASPAXLIB contains all of the ASAPX API
procedures.
ASAPXSRL The ASAPX procedure library as a native User Library.
ASAPXMON The processor monitor. One ASAPXMON executes in each processor
where an application process resides. ASAPXMON processes allocate and
manage shared memory and are responsible for metrics production,
objective analysis, and state production.
ASAPXSGP The Statistics Gathering process for ASAPX. ASAPXSGP acts as the
interface to ASAP and is responsible for starting and managing the ASAPX
environment. There is one SGP process per node. The SGP process is part
of ASAP, and is started and managed by ASAPMON.
ASAPXSRO The relocatable object file used to create ASAPXSRL. It can be bound into
an existing private application SRL. Do not use this file unless absolutely
necessary. Any change to the API procedures requires recompilation of
application code.
ASAPXTST The internal ASAPX API test program. It is available for testing and
educational purposes.
File Description
ASAPXDEC The ASAPX API procedure external declarations for TAL programs
ASAPXH The ASAPX API procedure external declarations for C programs