SQL/MX Programming Manual for C and COBOL (H06.10+, J06.03+)

COBOL Program Compilation
HP NonStop SQL/MX Programming Manual for C and COBOL—544617-003
16-11
Preprocessor Output
•
Converts the SQL statement to a COBOL comment in the COBOL annotated
source file.
•
Writes data structure initialization statements needed for arguments to the CLI
procedure calls and writes the appropriate CLI procedure call or calls for the SQL
statement immediately after the commented statement in the COBOL annotated
source file. At run time, the calls invoke the SQL/MX executor to execute the
procedure for the SQL statement within the module.
•
Writes the executable SQL statement to a separate module definition file if you use
the -x or -m preprocessor option or set the
SQLMX_PREPROCESSOR_VERSION=800 environment variable.
Use the preprocessor to embed SQL anywhere in the COBOL source file. However,
the preprocessor determines in which part of the source file the embedded SQL is
located and issues warnings if an embedded SQL statement is not placed correctly.
See Placement of SQL Statements on page 2-2.
At the end of processing the embedded SQL COBOL source file, the preprocessor
checks the status of static cursors:
•
Cursors accessed and not opened return an error message.
•
Cursors declared and not accessed return a warning message.
Preprocessor Output
COBOL Annotated Source File for Embedded Module
Definitions
The SQL/MX COBOL preprocessor processes a COBOL source file, such as source-
file.ecob, and generates one COBOL annotated source file (source-file.cbl)
as its output file. The annotated source file contains the embedded module definitions.
COBOL Annotated Source File for Module Definition Files
If you use the -x or -m preprocessor option or if you set the
SQLMX_PREPROCESSOR_VERSION=800 environment variable, the preprocessor
processes a COBOL source file, such as source-file.ecob, and generates two
files: the annotated source file (source-file.cbl) and the module definition file
(source-file.m).
For more information on module management behavior and influencing the
preprocessor, see Module Management Behavior on page 17-7. For recommended
naming conventions for COBOL source files, see Table 17-1 on page 17-1.
The preprocessor converts the embedded SQL statements to COBOL comments,
followed by the appropriate CLI calls.