Identifying Preprocessor Input

In the simplest case, illustrated earlier in Figure 1-1, the ALLBASE/SQL C program consists of one source code file and, optionally, one or more user include files; both the source code and the include files can contain SQL commands. The preprocessor merges any include files into the source program, and preprocesses it. The resulting modified source code file is then compiled and linked in the same manner as a C program not containing embedded SQL statements. (Include files must either exist in the current group or be specified with an account and group name.)

Regardless of the preprocessing mode you use, the source file and the ALLBASE/SQL message catalog must be available when you invoke the C preprocessor, as shown in Figure 2-5.

Source File

The source file is a file containing the source code of the C ALLBASE/SQL program with embedded SQL commands for one or more DBEnvironments. The default input filename is:

   SQLIN

An alternative name can be specified by using the DROP option in the preprocessor command line, as explained earlier in this chapter.

When parsing the source file, the C preprocessor ignores most C statements and C compiler directives in it. Only the following information is parsed by the C preprocessor:

The C compiler directive, include.
The source file name. Unless you specify a module name in the preprocessor command line, the preprocessor uses the source file name as the name for the module it stores. A module name can contain as many as 8 bytes and must follow the rules governing ALLBASE/SQL basic names (given in the ALLBASE/SQL Reference Manual).
Constructs found between the prefix EXEC SQL and the suffix ;. These constructs follow the rules given in Chapter 1 for how and where to embed these constructs.
Constructs found between the BEGIN DECLARE SECTION and END DECLARE SECTION commands. These commands delimit a declare section, which contains C data declarations for the host variables used in the program. Host variables are described in Chapter 3.

ALLBASE/SQL Message Catalog

The ALLBASE/SQL message catalog, contains preprocessor messages and ALLBASE/SQL error and warning messages. The fully qualified name for the default message catalog is:

   SQLCT000.PUB.SYS

For native language users, the name of the catalog is:

   SQLCTxxx.PUB.SYS

where xxx is the numerical value for the current language. If this catalog is not available, ALLBASE/SQL issues a warning and uses the default catalog instead.

When you run the preprocessor in full preprocessing mode, also ensure that the DBEnvironment accessed by the program is available.

Figure 2-5 Full Preprocessing Mode Input and Output

Identifying Preprocessor Input

Technical documentation

» Table of Contents

» Index

Source File

ALLBASE/SQL Message Catalog