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 INCLUDEand, 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 512for sources written for Pro*COBOL withformat=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 withEXEC 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:
dfor$1(default),afor?,cfor:1. See Parameter placeholders. -P MODE,--picx-as MODE-
how
PIC Xhost variables are sent:char(default),charforvarchar(see Fixed-length character strings). -Y LEN,ARR,--varying LEN,ARR-
the suffixes of the length and data items of the
VARYINGgroups (defaultLEN,ARR). -N SIZE,--varying-length-size SIZE-
the size in bytes of the length items of the
VARYINGgroups:4(default) or2(Pro*COBOL). --no-rec-code CODE-
the
SQLCODEof the “no record” condition, tested byWHENEVER 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.