CONNX Data Integration Suite 14.8.0 | CONNX Embedded SQL for Adabas | Programming Guide - C | Invocation and Precompiler Options - C | On Windows - C
 
On Windows - C
The general format of the call to the C precompiler is:
acepcc [<precompiler options>] <source file>
The C source file can have any extension. If no extension is supplied, the default extension 'pcc' will be used. If the source file cannot be located, an error will be returned.
Options
Every option begins with a minus sign (-). The names of the options are not case-sensitive.
The following C precompiler options are available:
Option, Option Name
Description
Default
-a, catalog name
If a table name exists multiple times in the CDD, and is not fully qualified with CATALOG.SCHEMA.TABLE, an 'ambiguous table reference' error will occur.
The default catalog name can be supplied with '-a <catalog_name>'.
The catalog name must exist in the CDD.
-b, suppress trailing blanks
Suppress character string trailing blanks.
Character string Host-Variables used for input or output are padded with trailing blanks as required.
Trailing blanks can be suppressed with '-b'.
This is especially useful for applications written in C/C++, where it is normal practice for character strings to be NULL terminated without trailing blanks padding.
no
-c, compatibility mode
The Precompiler executes in extended ACE mode.
ANSI mode can be enabled with '-c ANSI'.
This option affects messages only. In ANSI mode, SQL syntax, which does not adhere to ANSI standards, will be flagged as a warning.
Code generation is not affected.
Values : ACE / ANSI
ace
-e, error listing file
Error, Warning, and Statistics messages are written to STDOUT. These messages can be routed to an output file with '-e <error listing file>'.
The <error listing file> name must consist of at least a basename and ,optionally, an extension. If no extension is supplied, the default extension 'pcl' will be used.
On z/OS platforms, a DDNAME must be used instead of a filename, using the format :
-e //ddn:ddname
The DDNAME assignment must be made to a physical file. It must not be assigned to // DD SYSOUT=
<basename>.plc (Windows and Open Systems)
DD=SYSTERM (z/OS)
-f, code output file
The <code output file> name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'c' will be used.
<basename>.c
-k, keep the generated output file in case of compilation errors
The <code output file> is deleted after compilation errors.
The <code output file> can be kept with '-k'.
no
-l, generate line information
Line information in the form:
/* line nn "<source file name>" */
is generated into the <code output file> with '-l'.
This can be useful when you want to know the line number of the associated SQL Statement in the original C/C++ source file.
no
-m, migration check of SQL statements only
The Precompiler executes in code generation mode. When migrating or checking existing C/C++ or COBOL programs, it can be useful to have a listing of only the SQL statements. These are output to STDOUT. No output file is generated.
The migration check can be enabled with '-m'.
no
-n, Adabas SQL Gateway server name
This option is REQUIRED
Server <server_name> to which the session has to connect.
<server_name> does not need to be enclosed in quotes.
no default
-o, output code mode
Output code mode is either 32 or 64-Bit.
The C/C++ Precompiler generates 32-Bit code when invoked on 32-Bit systems (-o 32) and 64-Bit code when invoked on 64-Bit systems (-o 64).
Generation of code suitable for a different environment can be enabled with '-o 32' or '-o 64'.
Values : 32 / 64
32 (when invoked on 32-Bit systems)
64 (when invoked on 64-Bit systems)
-q, no SQL validation
The Precompiler performs SQL syntax validation at precompile time.
SQL validation can be disabled with '-q'.
no
-r, length of output line
The Precompiler generates code output files with a line length of 72.
The output line length can be increased to the length defined in <output line length>.
The output line length cannot be defined shorter than the default length for the appropriate Host Language. If this is attempted, the output line length will be reset to the appropriate Host Language default and a warning message is issued.
Values : >= 72
72
-s, schema name
The SCHEMA name used by the Precompiler is derived from <user_name> as supplied with the '-u' option.
The default schema name can be overridden with '-s <schema_name>'.
The schema name must exist in the CDD.
user_name
-u user name [, password]
This option is REQUIRED
User <user_name> and Password <password> for the connection to the Server defined with '-n'.
The <password> parameter is optional, however, this must be supplied if the user being connected requires a password.
no default
-w. working directory
Input and output files are searched for or stored in the current directory. This can be overridden with '-w <working directory>'.
If no filename is given for a file to be generated, the basename of the precompiler source file will be taken, with the appropriate extension.
current directory
-z. suppress warnings
Warning messages are generated by the Precompiler.
Warning messages can be suppressed with '-z'.
This option affects WARNING messages only. ERROR messages cannot be suppressed.
no
-@, file containing command line options and parameters
Command line options and parameters saved in a file can be optionally input to the Precompiler with '-@ <command line options and parameters file>'.
The options and parameters in the <command line options and parameters file> can be combined with other command line options when invoking the Precompiler.
On z/OS platforms, a DDNAME must be used instead of a filename, using the format :
-@ //ddn:ddname
The DDNAME assignment must be made to a physical file. It must not be assigned to // DD *
no default
Note: 
The minimum required options are server name (-n) and user name (-u). All other options are optional.
Filename Conventions
*The C precompiler source file name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'pcc' will be used. If the source file cannot be located, an error will be returned.
*The C precompiler generated output file name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'c' will be used.
*The (optional) C precompiler listing file name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'pcl' will be used.
*If no directory is given, then the file will be searched or stored in the current directory. If a working directory is set (W option), then all generated files will be stored there. This setting can be overridden by a directory indication within a certain filename. If no filename is given for a file to be generated, then the basename of the precompiler source file will be taken, with the appropriate extension.
Examples:
acepcc -nDD=MYDSN -uMYUSER precapp.pcc
All generated files will be stored in the current directory. The code output file (C source) is assigned the name precapp.c.
acepcc -nDD=MYDSN,GATEWAY=REMOTEHOST,PORT=7500 -uMYUSER precapp.pcc
All generated files will be stored in the current directory. The code output file (C source) is assigned the name precapp.c. A remote connection will be made to the CONNX JDBC Server, listening on PORT 7500.
acepcc -nDD=MYDSN -uMYUSER -wC:\TEMP -fD:\CSRC\MYSRC.CPP precapp.pcc
This precompiler call stores all generated files in c:\temp except the generated C source. This will be stored in d:\csrc with the name mysrc.cpp. The name of the source file of the precompiler is precapp.pcc.
Libraries
To build an executable program (or a dynamic link library), only the rciclnt.lib must be linked to the objects which are the result of preceding executions of a C compiler. Example:
cl precapp.c c:\connx32\precompiler\rciclnt.lib