Rational Developer for System z
Enterprise COBOL for z/OS, Version 4.1, Programming Guide


Compiling with the CICS option

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:

Table 1. Compiler options required for the integrated CICS translator
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 references  
CICS  
Conflicting compiler options


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)