Prerequisite Tasks

  • Invoke the cicsmap command for any map sets that your application program uses. See cicsmap - generate BMS map files.
  • If you have COBOL copybooks that contain EXEC CICS statements, use cicstran - translates source code to translate them.
  • Note: This step is not required if you are using the –p option to compile IBM® COBOL applications. When you use this option, the IBM COBOL compiler will automatically preprocess the EXEC CICS® statements that are present in the copybooks. This translation step is not required for COBOL-IT COBOL applications if preprocess compiler option is used. When preprocess option is used the cobc compiler automatically preprocesses the EXEC CICS statements that are there in the copybooks.

If necessary, set compile and link options. These are not normally required, because cicstcl attempts to supply sensible defaults but, if needed, they are supplied as shown in Table 1 and Table 2. The values that are listed are the environment variables from which the cicstcl command obtains the flags and directories that it uses when compiling and linking programs. For more information about these flags, see the sections in this chapter on the language that you are using.

Table 1. Setting compile and link options for cicstcl (CICS on Open Systems). Setting compile and link options for cicstcl (CICS on Open Systems)
Compiler Compile flags Linker flags Libraries to link Include directories
C/C++ CCFLAGS LDFLAGS USERLIB  
IBM COBOL CICS_IBMCOB_FLAGS LDFLAGS USERLIB SYSLIB
Micro Focus COBOL COBOPTS     COBCPY
IBM PL/I CICS_IBMPLI_FLAGS LDFLAGS USERLIB  
COBOL-IT COBITOPT     COBCPY
Table 2. Setting compile and link options for cicstcl (CICS for Windows). Setting compile and link options for cicstcl (CICS for Windows)
Compiler Compile flags Linker flags Libraries to link Include directories
IBM COBOL CICS_IBMCOB_FLAGS USERLIB USERLIB  
Micro Focus COBOL COBOPTS     COBCPY
Microsoft C/C++ CICS_MSC_FLAGS LINK USERLIB  
IBM PL/I CICS_IBMPLI_FLAGS      
COBOL-IT COBITOPT     COBCPY
Note: If you have IBM VisualAge® COBOL installed, the COBOL directories must be in the PATH system environment variable before the C++ directories.