The integrated CICS translator

In earlier CICS® releases, CICS application programs had to be translated before they could be compiled. The translators find EXEC CICS commands, make them into comments, and generate CALLs appropriate to the language. The CICS-supplied jobs for compiling user application programs all contain an initial job step that invokes the translator appropriate to the compiler invoked in the following job step.

The CICS-supplied separate translators change the line numbers in source programs, which means that an intermediate listing, with the translator-generated CALLs, which must be used when debugging an application program. With the integrated translator, application development is made easier because there is only one listing -- the original source statements, and the CICS error messages are included in the compiler listing. The process of translating and compiling is also less error-prone because it is no longer necessary to translate included members separately.

The Language Environment-conforming language compilers that support the integrated CICS translator scan the application source and call the integrated CICS translator at relevant points.

Start of changeThe releases of the COBOL and PL/I compilers which support the CICS integrated translator are listed in the CICS Release Guide. Start of changeThe integrated translator is supported in z/OS V1.7 XL C/C++ and later compilers.End of change If you use any other compiler, including Assembler, you will need to translate your program in the traditional way described in Translation and compilation.End of change

Using the integrated CICS translator

The language compilers provide various procedures that you can use with the integrated CICS translator. They are documented in the Programming Guides for Enterprise Start of changePL/IEnd of change for z/OS® and for Start of changeXL C/C++End of change.

The procedure that you use needs to have CICSTS31.CICS.SDFHLOAD added to the STEPLIB concatenation for the compile step and the link-edit step should include the interface module DFHELII at the start of the step.

To use the integrated CICS translator for PL/I you must specify the compiler option SYSTEM(CICS).

Start of changeStart of changeTo use the integrated CICS translator for COBOL, the compiler options CICS, LIB, NODYNAM, and RENT must be in effect. NODYNAM is not a restriction specific to the integrated translator. DYNAM is not supported for code that is separately translated and compiled. End of changeDo not use SIZE(MAX), because storage must be left in the user region for integrated CICS translator services. Instead, use a value such as SIZE(4000K), which should work for most programs.End of change

If you are running DB2® Version 7 or later and preparing a COBOL program using a compiler with integrated translator, the compiler also provides an SQL statement coprocessor (which produces a DBRM), so you do not need to use a separate DB2 precompiler. See the CICS DB2 Guide and the DB2 for OS/390® and z/OS Application Programming and SQL Guide for more information on using the SQL statement coprocessor.

Start of changeTo use the integrated CICS translator for C and C++, use the CICS option.End of change

Specifying CICS translator options

Start of changeTo specify CICS translator options when using the XL C/C++ compiler specify the compiler option, CICS, with the translator options inside parentheses. For example:

CICS(opt1 opt2 optn ...)
End of change

To specify CICS translator options when using the PL/I compiler specify the compiler option, PP(CICS), with the translator options enclosed in apostrophes and inside parenthesis. For example:

PP(CICS('opt1 opt2 optn ...'))

For more information on specifying PL/I compiler options see the Enterprise PL/I for z/OS and OS/390 Programming Guide.

To specify CICS translator options when using the COBOL compiler specify the compiler option, CICS, with the translator options enclosed in apostrophes and inside parenthesis. For example:

CICS('opt1 opt2 optn ...')
Note:
The XOPTS translator option must be changed to the CICS compiler option. XOPTS is not accepted when using the integrated CICS translator.

For more information on specifying COBOL compiler options see the Enterprise COBOL for z/OS and OS/390: Programming Guide.

For a description of all of the translator options see Defining translator options.

Many of the translator options, such as those associated with translator listings, do not apply when using the integrated CICS translator. These options, if specified, are ignored. The EXCI option is not supported, the CICS option is assumed.

The translator options that can be used effectively with the integrated CICS translator are:

[[ Contents Previous Page | Next Page Index ]]