Developer for System z® sets CICS® preprocessor
options appropriate to the level of CICS installed
on the workstation or remote system. This section outlines several
scenarios for local and remote syntax checking of CICS programs and describes how Rational® Developer for System z handles each.
Local syntax check of a remote CICS program
The following scenarios
illustrate how Developer for System
z sets compiler options for a local syntax check of a remote CICS program:
- On the Runtime Environments page for a remote file, you select CICS
(contains EXEC CICS statements) and specify a level of CICS from the drop-down list. Developer
for System z sets compiler
options for the local syntax check according to the remote compiler
options specified:
- On the Local Compile Options page for a remote file, you specify
the CICS('CTSxx') (for COBOL) or pp(CICS('CTSxx')
(for PL/I) option, where xx is the level of CICS. Developer for System z uses the option specified for local
syntax check using host CICS syntax
and does the following operations:
- Ensures that TXSeries is
installed.
- When the CICS compiler
option is specified, the Preprocessor options
are ignored on a syntax check.
- Performs a syntax check with the CICS('CTSxx') (for
COBOL) or pp(CICS('CTSxx') (for PL/I) compiler
option, causing the integrated CICS translator
with the specified syntax to be invoked.
Rational Developer
for System z does not support
TXSeries, local syntax check, or local build on the Linux platform.
Local syntax check of a local CICS program
The following scenarios
illustrate how Developer for System
z sets compiler options for a local syntax check of a local CICS program:
- On the Local Compile Options page for a local file, you specify
that an integrated CICS syntax
check should take place. Developer for System z sets compiler options for the local
syntax check as follows, ensuring that the integrated preprocessor
is used:
- Ensures CICS TXSeries 6.1
or higher is installed.
- Changes the compiler options to include CICS.
- Preprocessor options are ignored on the
syntax check.
- Performs the syntax check using the integrated CICS translator.
- On the Local Compile Options page for a local file, you specify
the CICS('CTSxx') (for COBOL) or pp(CICS('CTSxx')
(for PL/I) option, where xx is the level of CICS. Developer for System z sets compiler options for the local
syntax check as follows, ensuring that the integrated preprocessor
is used with the level of CICS Transaction
Server syntax specified:
- Ensures that TXSeries 6.1
or higher is installed.
- Ignores Preprocessor options.
- Performs the syntax check using the integrated CICS translator.
- On the Local Compile Options page for a local file, you specify
the -p preprocessor option indicating use of CICSTCL (CICS Translate Compile Link) with the integrated
translator. Developer for System
z uses the option specified for local syntax check with the integrated
translator and does the following operations:
- Ensures that TXSeries 6.1
or higher is installed.
- Ignores Preprocessor options.
- Adds the CICS compiler
option for syntax check.
- Performs a syntax check with the CICS compiler
option, causing the integrated CICS translator
to be invoked.
Local build of a local CICS program
The
following scenarios illustrate how Developer for System z sets compiler options for a local
build of a local CICS program
(building a DLL to run in a region):
- On the Local Compile Options page for a local file, you specify
a the -p preprocessor option indicating use of CICSTCL (CICS Translate Compile Link) with the integrated
translator. Developer for System
z uses the option specified for the local build with the integrated
translator and runs two compilation passes as follows:
- Ensures that TXSeries 6.1
or higher is installed.
- On the compilation pass, Developer for System z:
- Changes options fed to the compiler to include CICS.
- Ensures that the integrated translator is called, and ignores
the Preprocessor field.
- Performs the compilation as though it were a regular (non-CICS)
compilation.
- On the CICSTCL pass, Developer for System z:
- Performs the CICSTCL pass with the -p and other options specified
in the Preprocessor options field.
- On the Local Compile Options page for a local file, you specify
the CICS compiler option for
completing a compilation with an integrated CICS translator. Developer for System z uses the option specified for the
local build with the integrated translator and runs two compilation
passes as follows:
- Ensures CICS TXSeries 6.1
or higher is installed.
- On the compilation pass, Developer for System z:
- Passes the CICS compiler
option to the compiler.
- Ensures that the integrated translator is called, and ignores
the Preprocessor field.
- Performs the compilation as though it were a regular (non-CICS)
compilation.
- On the CICSTCL pass, Developer for System z:
- Infers, by the presence of the CICS compiler
option, that you also mean to use the integrated translator for the
CICSTCL.
- Adds the -p preprocessor option and performs the CICSTCL pass
with the -p and other options specified in the Preprocessor options
field.
- On the Local Compile Options page for a local file, you specify
the CICS('CTSxx') (for COBOL) or pp(CICS('CTSxx')
(for PL/I) option, where xx is the level of CICS. Developer for System z issues a warning message and writes
a warning to the log. The CICS('CTSxx') or pp(CICS('CTSxx') compiler
option is meant only for syntax checking.