ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application

HP NonStop ASAP Extension Manual—425265-004

4-5

Domain Name Examples

These domain names are all valid:

Atmapplicationserver1

Atm\Withdrawals\Requesters\Test\$Test23

Atm\Deposit\Zeist-north\Local\$Line.#su387

Setting a Version Identifier

Using a version identifier helps show the impact of new versions on application

statistical data. ASAPX supports an optional 2-byte version identifier for each

application domain registering with ASAPXMON as one of the 11 possible built-in

attributes. If you set the version identifier when registering with ASAPX and include the

EDL definition for the Version attribute in your EDL file, ASAPXMON inserts that

domain version identifier into each statistics record it generates.

To set the version identifier, supply a 2-byte alphanumeric value to the registration

procedure.

Registering a Domain

To register a domain, call the ASAP_REGISTER_ procedure. The only required

parameters are the domain name string and length and, if extended memory is already

in use, the segment ID and base address. You can also supply the ASAP identifier

(ASAPID) if it is not the default, and the domain version.

The ASAP_REGISTER_ procedure communicates with the ASAPXMON process in its

processor to register the domain. The procedure then returns a 32-bit address to the

caller, with a return code of 0 if successful and an error if not successful. The

application must maintain the 32-bit address in global memory because it is a required

parameter for the procedure calls that update the metric values and for the removal

procedure.

Registration Verification Rules

To verify that a process is eligible for registration, ASAPX validates information about

the process and its request:

•

The process must run on the same node and processor as the ASAPXMON

process. The registration procedure handles this, but ASAPXMON performs

verification.

•

The process must be named with a permanent process name that it carries

throughout its measurement. The process must supply its correct process name in

the registration message to ASAPXMON. The registration procedure also handles

this.

•

The process must have specified a valid domain name and domain name length in

the call to the registration procedure.