Preprocessing, Compiling, and Linking

Creating C++ CICS Applications under TSO

You must execute these three separate CLISTs to create a C++ CICS application under TSO:

LCCCP invokes the CICS translator.

LCXX invokes the C++ translator and compiler.

COOL invokes the SAS/C prelinker and linkage editor to generate a load module.

The LCCCP CLIST

In the LCCCP CLIST, use an input data set with a final qualifier of CPP. The output data set name is specified with the output option; the final qualifier should be C. In the following example, the output data set name is fully qualified because the data set name has a different final qualifier (CXX) than the one expected by the LCXX CLIST. Use standard TSO naming conventions to specify all data set names.

Assuming an input data set named USERID.CICS.CPP and an output data set named USERID.CICS.CXX, the LCCCP CLIST can be invoked as follows:

LCCCP CICS(SAMPLE)
 OUTPUT('''USERID.CICS.CXX(SAMPLE)''')

The LCXX CLIST

In the LCXX CLIST, the final qualifier of the input and output data sets should be CXX and OBJ, respectively. Assuming an input data set named USERID.CICS.CXX and an output data set named USERID.CICS.OBJ, the LCXX CLIST can be invoked as follows using the object option:

LCXX CICS(SAMPLE) OBJECT(CICS(SAMPLE)) RENT

The object option specifies the data set in which the output from the C++ translator will reside. Use standard TSO naming conventions to specify the data set names if qualifiers other than those noted are used.

Note: Always compile CICS applications with the RENT compiler option.

For additional information on the LCXX CLIST, refer to SAS/C Cross-Platform Compiler and C++ Development System User's Guide. [cautionend]

The COOL CLIST

The COOL CLIST invokes the SAS/C prelinker and the linkage editor; the final qualifier of the input data set should be OBJ. Use the LOAD option to specify the data set in which the linkage editor stores the output load module. If the LOAD option is not specified, various rules apply as to how this data set will be determined. Consult Chapter 7, "Linking C Programs," in the SAS/C Compiler and Library User's Guide for additional information on these rules.

Assuming an input data set of USERID.CICS.OBJ and an output data set name of USERID.CICS.LOAD, the COOL CLIST can be invoked as follows:

COOL CICS(SAMPLE) CICS CXX RENT LOAD(CICS(SAMPLE))

The CXX and CICS options are needed to add the required libraries to COOL's autocall list. Use standard TSO naming conventions to specify the data set names if qualifiers other than those noted here are used.

Note: CICS applications must always be link-edited with the RENT option. [cautionend]

Chapter Contents
Previous
Next
Top of Page

LCCCP	invokes the CICS translator.
LCXX	invokes the C++ translator and compiler.
COOL	invokes the SAS/C prelinker and linkage editor to generate a load module.