On UNIX - COBOL
The general format of the call to the COBOL precompiler is:
ACEPCCOB [<precompiler options>] <source file>
The COBOL source file can have any extension. If no extension is supplied, the default extension 'pccob' is used. If the source file cannot be located, an error is returned.
Filename Conventions
The COBOL precompiler source file name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'pccob' is used. If the source file cannot be located, an error is returned.
The COBOL precompiler generated output file name must consist of at least a basename and, optionally, an extension. If no extension is supplied, the default extension 'cbl' is used.
The (optional) COBOL 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:
ACEPCCOB -nDD=MYDSN -uMYUSER prebapp.pccob
All generated files will be stored in the current directory. The code output file (COBOL source) is assigned the name prebapp.cbl.
ACEPCCOB -nDD=MYDSN,GATEWAY=REMOTEHOST,PORT=7500 -uMYUSER prebapp.pccob
All generated files will be stored in the current directory. The code output file (COBOL source) is assigned the name prebapp.cbl. A remote connection will be made to the CONNX JDBC Server, listening on PORT 7500.
ACEPCCOB -nDD=MYDSN -uMYUSER -wC:\TEMP -fD:\COBSRC\MYSRC.CBL prebapp.cob
This precompiler call stores all generated files in /TEMP, except the generated COBOL source. This will be stored in /COBSRC with the name mysrc.cbl. The name of the source file of the precompiler is prebapp.cob.
Libraries
To build an executable program (or a dynamic link library), only the shared library rciclnt.so must be linked to the objects which are the result of preceding executions of a COBOL compiler. Example:
ld prebapp.o -lrciclnt