Using the CICS-supplied procedures to install application programs

CICS® supplies job control statements (JCL) for the translate (if required) , compile, and link-edit steps, in separate cataloged procedures for each programming language supported. After CICS is installed, you should copy these procedures, installed in the CICSTS31.CICS.SDFHPROC library, into a procedure library.

Each procedure has a name of the form DFHwxTyL, 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. Using the preceding naming convention, the procedure names are given in Table 6.

Table 6. Procedures for installing application programs
Language Language Environment®-conforming compilers non-Language Environment-conforming compilers
Stand-alone translator EXCI Integrated translator Stand-alone translator EXCI
Assembler - - - DFHEITAL DFHEXTAL
C DFHYITDL (see note 1) DFHYXTDL Start of changeDFHZITDL (see note 2)End of change - -
Start of changeC using the XPLINK compiler optionEnd of change Start of changeDFHYITFL (see note 2)End of change Start of change-End of change Start of changeStart of changeDFHZITFL (see note 2)End of changeEnd of change Start of change-End of change Start of change-End of change
C++ DFHYITEL (see note 1) DFHYXTEL Start of changeDFHZITEL (see note 2)End of change - -
Start of changeC++ using the XPLINK compiler optionEnd of change Start of changeDFHYITGL (see note 2)End of change Start of change-End of change Start of changeStart of changeDFHZITGL (see note 2)End of changeEnd of change Start of change-End of change Start of change-End of change
COBOL (see note 4) DFHYITVL DFHYXTVL Start of change(see note 3)End of change DFHZITCL (see note 2) - -
PL/I (see note 5) DFHYITPL (see note 2) DFHYXTPL DFHZITPL (see note 2) - -
Notes:
  1. DFHYITEL may also be used for C as long as you specify the correct name of the C compiler on the COMPILER parameter.
  2. Start of changeThe output library for the generated module is a PDSE (not a PDS).End of change
  3. Start of changeA separate translator step must be used for EXCI COBOL programs as translator options are ignored when using the integrated CICS translator.End of change
  4. Start of changeDFHZITCL is the recommended procedure for compiling COBOL modules, because it uses the version of the Enterprise COBOL compiler which includes the integrated CICS translator. Start of changeHowever, if the COBOL program is intended for batch processing using the EXCI option, then the integrated translator cannot be used.End of changeEnd of change
  5. Start of changeDFHZITPL is the recommended procedure for compiling PL/I modules as it uses the version of the Enterprise PL/I compiler which includes the integrated CICS translator. Start of changeHowever, if the PL/I program is intended for batch processing using the EXCI option, then the integrated translator cannot be used.End of changeEnd of change
  6. Start of changeFor programs that issue EXEC DLI commands in a batch environment under Language Environment (IMS routines), use the following special procedures:
    DFHYBTPL
    PL/I application programs
    DFHYBTVL
    COBOL application programs
    End of change

Installing programs in load library secondary extents

CICS supports load library secondary extents that are created while CICS is running. If you define libraries in the DFHRPL concatenation with primary and secondary extents, and secondary extents are added as a result of link-editing into the DFHRPL library while CICS is running, the CICS loader detects the occurrence, closes, and then reopens the library. This means that you can introduce new versions using the CEMT NEWCOPY command, even if the new copy of the program has caused a new library extent.

However, this can increase the search time when loading modules from the secondary extents. You should avoid using secondary extents if possible.

Note:
If you are using DFHXITPL, the SYSLMOD DD statement in the binder step must refer to a PDSE (not a PDS as for the older PL/I compilers).
[[ Contents Previous Page | Next Page Index ]]