Previous Topic: Passing Syntax to CA OLQNext Topic: Managing Storage

CA ADS Runtime System › Linking Built-In Functions With The Runtime System

Linking Built-In Functions With The Runtime System

All CA-supplied BIF modules are linked with ADSOMAIN and all user-written BIF modules can optionally be linked together as a new ADSOVCON module.

Note: Creating an ADSOVCON module is not required. CA ADS dynamically loads user-written BIFs if they are not linked with ADSOVCON.

ADSOVCON Module Creation

Optionally create an ADSOVCON module using the #BIFVCON macro to identify your user-written BIF modules to be linked together. The following sample ADSOVCON module indicates that the UDATE and UCHECK BIF modules are to be linked with ADSOVCON. 

#BIFVCON TYPE=INITIAL                             
#BIFVCON TYPE=ENTRY,PROGRAM=UDATE,EPNAME=UDATE 
#BIFVCON TYPE=ENTRY,PROGRAM=UCHECK,EPNAME=UCHKEP1
#BIFVCON TYPE=FINAL

To create an ADSOVCON module, create a source member as described in the following section and save it in your custom source library. Then assemble and link it into your custom load library.

The following diagram shows the syntax for the #BIFVCON macro:

►►──────── #BIFVCON TYPE= ─┬─ INITIAL ─┬──────────────────────────────────►
                           ├─ ENTRY ───┤  
                           └─ FINAL ───┘  

 ►──────────────── ,PROGRAM=program-name ─────────────────────────────────►

 ►───────────────── ,EPNAME=entry-point-name ─────────────────────────────►◄

#BIFVCON Macro Parameters

This section describes the parameters for for the #BIFVCON macro.

TYPE

Indicates the type of BIFVCON statement being generated.

INITIAL

Identifies the first BIFVCON statement in the program.

ENTRY

Identifies a BIFVCON statement defining a user-written BIF module.

FINAL

Identifies the last BIFVCON statement in the program.

PROGAM=program-name

Identifies the name of a user-written BIF module to be linked with ADSOVCON. program-name must be the same as the program name associated with a built-in function declared in your RHDCEVBF module.

This parameter is valid only if TYPE=ENTRY is coded.

EPNAME=entry-point-name

Identifies the name of the entry point of the user-written BIF module. entry-point-name must be the name of the entry point in the program identified by program-name.

This parameter is valid only if TYPE=ENTRY is coded.