Use the CICS compiler option to enable the integrated CICS translator and to specify CICS suboptions.
If you specify the NOCICS option, the compiler diagnoses and discards any CICS statements that it finds in your source program. If you have already used the separate CICS translator, you must use NOCICS.
You can specify the CICS option in any of the compiler option sources: compiler invocation, PROCESS or CBL statements, or installation default. When the CICS option is the COBOL installation default, you cannot specify CICS suboptions. However, making the CICS option the installation default is not recommended, because the changes that are made by the integrated CICS translator are not appropriate for non-CICS applications.
All CBL or PROCESS statements must precede any comment lines, in accordance with the rules for Enterprise COBOL.
The COBOL compiler makes available to the integrated CICS translator the CICS suboption string that you provide in the CICS compiler option. Only that translator views the contents of the string.
When you use the integrated CICS translator, you must compile with the following options:
| Compiler option | Comment |
|---|---|
| CICS | If you specify NOLIB, DYNAM, or NORENT, the compiler forces LIB, NODYNAM, and RENT on. |
| LIB | Must be in effect with CICS |
| NODYNAM | Must be in effect with CICS |
| RENT | Must be in effect with CICS |
| SIZE(xxx) | xxx must be a size value (not MAX) that leaves enough storage in your user region for the integrated CICS translation process. |
In addition, IBM recommends that you use the compiler option WORD(CICS) to cause the compiler to flag language elements that are not supported under CICS.
To compile your program with the integrated CICS translator, you can use the standard JCL procedural statements that are supplied with COBOL. In addition to specifying the above compiler options, you must change your JCL in two ways:
The default name of the data set for CICS Transaction Server V3R2 is CICSTS32.CICS.SDFHLOAD, but your installation might have changed the name. For example, you might have the following line in your JCL:
//STEPLIB DD DSN=CICSTS32.CICS.SDFHLOAD,DISP=SHR
The COBOL compiler listing includes the error diagnostics (such as syntax errors in the CICS statements) that the integrated CICS translator generates. The listing reflects the input source; it does not include the COBOL statements that the integrated CICS translator generates.
Compiling a sequence of programs: When you use the CICS option to compile a source file that contains a sequence of COBOL programs, the order of precedence of the options from highest to lowest is:
related concepts
Integrated CICS translator
related tasks
Coding COBOL programs to run under CICS
Separating CICS suboptions
CICS Application Programming Guide
related references
CICS
Conflicting compiler options