ASAP 2.7 Extension Manual

Implementing the ASAP Extension in an Application

HP NonStop ASAP Extension Manual—425265-004

4-6

ASAP_REGISTER_ Procedure

•

The domain name, in its final form, must be unique on the system where the ASAP

Extension executes.

•

If the application process allocated any extended segment files before calling the

base address that are allocated by the Register process. If a value is not supplied,

segment ID 0 is used.

ASAP_REGISTER_ Procedure

The ASAP_REGISTER_ procedure registers a domain in ASAP. It can be called

multiple times by a process if it participates in multiple domains, but domain names

must be unique across the entire ASAP Extension subsystem.

error

INT

returns a value indicating the outcome of the registration call.

error := ASAP_REGISTER_ ( domain^name:domain^name^len !i

, seg^offset !o

[, error^detail] !o

[, segment^id] !i

[, segment^base] !i

[, version] !i

[, asap^id:id^len] !i

[, flags] !i

[, timeout]) !i

Value Definition

0 No error. Registration was successful.

–1 The calling process is not named.

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

–3 Domain name error. The domain name is not formatted correctly.

–4 File-system error. Error^detail contains the file-system error number. This

could be an error encountered by ASAPXMON while attempting to register

the domain. Check the log for ASAPXMON error messages.

–5 Segment allocation error. Error^detail contains the error returned from the

SEGMENT_ALLOCATE_ procedure.

–6 ASAPXMON failed to validate the domain. The process that registers the

domain must be named and also on the same node and in the same CPU

as the ASAPXMON process. This error is also returned if statistics

collection has been disabled with the ASAPX DISABLE STATS command.

–7 Memory addressing error. The memory offset location returned by

ASAPXMON was incorrect, memory is corrupted, or ASAPXMON failed to

properly initialize the memory area to the requesting domain.