The gixpp precompiler

Synopsis

gixpp -e [options] -i <input> -o <output>

gixpp reads a COBOL source with embedded SQL and writes a COBOL source where the EXEC SQL blocks are commented out and replaced with calls to libgixsql.

Options

Input and output

-i FILE, --infile FILE
the input file.
-o FILE, --outfile FILE
the output file.
-I DIRS, --copypath DIRS
the directories where copybooks are searched (for EXEC SQL INCLUDE and, with -p, COPY). The option can be repeated.
-E EXTS, --esql-copy-exts EXTS
the extensions of the copybooks, separated by commas, for example -E ".,cpy,CPY".
-c, --consolidate
write a single source file, with the copybooks expanded.
-k, --keep
keep the temporary files.
-s FILE, --symfile FILE
write a symbol file.
-m, --map
write a map file (correspondence between the input and output lines).

Source format

--code-end-col N
the last column of the code area in fixed format, from 72 to 512 (default 72). The text after this column is ignored, with a warning. Use --code-end-col 512 for sources written for Pro*COBOL with format=terminal ireclen=512.
NoteTo be completed

Free format support.

ESQL processing

-e, --esql
process the embedded SQL statements. This option is required.
-p, --esql-preprocess-copy
process the embedded SQL statements in all the copybooks included with COPY, not only those included with EXEC SQL INCLUDE.
-S, --esql-static-calls
generate static calls to the runtime (CALL STATIC). Recommended.
-z STYLE, --param-style STYLE
the style of the parameter placeholders in the generated SQL statements: d for $1 (default), a for ?, c for :1. See Parameter placeholders.
-P MODE, --picx-as MODE
how PIC X host variables are sent: char (default), charf or varchar (see Fixed-length character strings).
-Y LEN,ARR, --varying LEN,ARR
the suffixes of the length and data items of the VARYING groups (default LEN,ARR).
-N SIZE, --varying-length-size SIZE
the size in bytes of the length items of the VARYING groups: 4 (default) or 2 (Pro*COBOL).
--no-rec-code CODE
the SQLCODE of the “no record” condition, tested by WHENEVER NOT FOUND (default 100; 1403 for Oracle). See The “no record” condition.
-C, --cobol85
generate COBOL 85 code.
NoteTo be verified

What --cobol85 changes in the generated code.

Debugging

-g, --debug-info
generate debug information.
-v, --verbose
verbose output.
-d, --verbose-debug
debug output.
-D, --parser-scanner-debug
trace the parser and the scanner.

Information

-h, --help
display the options.
-V, --version
display the version.

Generated code

NoteTo be completed

Show the code generated for a SELECT INTO: the commented statement, the CALL "GIXSQLExec..." sequence, and the generated SQ0001 data items holding the SQL text.