ASAP 2.7 Extension Manual

HP NonStop ASAP Extension Manual—425265-004

4-1

Implementing the ASAP Extension in

an Application

The ASAP Extension lets you configure applications to use the ASAP suite of services

through six provided API procedures.

This section describes programming for the ASAP Extension:

Implementing the ASAPX API in Your

Application

1. Design domain names for your application and across applications. You must

design domain names to properly reflect all applications using ASAPX in a

balanced-tree configuration. For more information, see Balanced Tree Design on

page 4-4.

2. Source in the ASAP-LIST structure definition from the files for C, COBOL, or TAL

(ZASPXC, ZASPXCOB, or ZASPXTAL, respectively). The structure definition files

reside in the ASAPX ISV subvolume and are required by the declaration files.

3. For TAL and C programs, source in the external declaration files ASAPXDEC and

ASAPXH, respectively. IP Setup places these files in the ASAPX ISV subvolume

during installation.

4. Include the ?SEARCH or ?LIBRARY compiler directives in your source file to

reference the ASAPXLIB procedure library, use BIND to modify your application

object files to use ASAPXLIB as a library, use the LIB runtime parameter to

reference ASAPXLIB or ASAPXSRL, use NLD to reference ASAPXSRO to link

your object with the shared-runtime library, or use ASAPXDLL with your position

independent code (PIC) application.

Topic API Procedure Page

Implementing the ASAPX API in Your Application

n.a. 4-1

Designing Domain Names n.a. 4-3

Setting a Version Identifier n.a. 4-5

Registering a Domain ASAP_REGISTER_ 4-5

Removing a Domain ASAP_REMOVE_ 4-10

Updating DataItems ASAP_UPDATE[LIST]_ 4-13

Controlling the Ranking of a Domain ASAP_CONTROL_ 4-20

Operational Status and State ASAP_OPSTATE_ 4-22