Using the CICS-supplied procedures to install application programs

CICS® supplies job control statements (JCL) for translate (if required), compile, and link-edit steps, in separate cataloged procedures for each supported programming language.

After CICS is installed, copy these procedures, which are installed in the CICSTS54.CICS.SDFHPROC library, into a procedure library. The name of each procedure is in the form DFH wx T y L, where the variables w , x , and y depend on the type of program (EXCI batch or CICS online), the type of compiler, and the programming language. The following tables show the procedure names.

Table 1. Procedures to install application programs: non-Language Environment-conforming compilers
Language Stand-alone translator EXCI
Assembler DFHEITAL (AMODE(24) and AMODE(31) applications)

DFHEGTAL (AMODE(64) applications)

 DFHEXTAL
Table 2. Procedures for installing application programs: Language Environment-conforming compilers
Language Stand-alone translator Integrated translator EXCI with Stand-alone translator EXCI with integrated translator
C DFHYITDL (see note 1) DFHZITDL (see note 1) DFHYXTDL DFHZXTDL
C using the XPLINK compiler option DFHYITFL (see note 2) DFHZITFL (see note 1) - -
C++ DFHYITEL (see note 1) DFHZITEL (see note 1) DFHYXTEL DFHZXTEL
C++ using the XPLINK compiler option DFHYITGL (see note 2) DFHZITGL (see note 1) - -
COBOL (see note 3) DFHYITVL DFHZITCL (see note 2) DFHYXTVL DFHZXTCL
PL/I (see note 4) DFHYITPL (see note 2) DFHZITPL (see note 2) DFHYXTPL DFHZXTPL (see note 6)
Notes:
  1. DFHYITEL can also be used for C; you must specify the correct name of the C compiler on the COMPILER parameter.
  2. The output library for the generated module is a PDSE (not a PDS).
  3. DFHZITCL is the recommended procedure for compiling COBOL modules because it uses the version of the Enterprise COBOL compiler that includes the integrated CICS translator.
  4. DFHZITPL is the recommended procedure for compiling PL/I modules because it uses the version of the Enterprise PL/I compiler that includes the integrated CICS translator.
  5. For programs that issue EXEC DLI commands in a batch environment under Language Environment® ( IMS routines), use these special procedures:
    DFHYBTPL
    PL/I application programs
    DFHYBTVL
    COBOL application programs.
    Note: This procedure requires the macro DFHLI000.
  6. Requires APAR PI34113 to be applied to Enterprise PL/I version 4.2, 4.3 or 4.4, or APAR PI35108 to be applied to Enterprise PL/I version 4.5