Using the CXXMOD EXEC under TSO/E

This topic describes how to prelink and link your C++ or COBOL program by invoking the CXXMOD EXEC. This exec creates an executable module. The syntax for the CXXMOD EXEC is:

Syntax

                   .-,------------.      
                   V              |      
>>-CXXMOD--OBJ--(----+-object---+-+--)-------------------------->
                     '-'object'-'        

>--+------------------------------------+----------------------->
   |          .-,------------------.    |   
   |          V                    |    |   
   '-POPT--(------prelink-option---+--)-'   

>--+-------------------------------+---------------------------->
   |          .-,-------------.    |   
   |          V               |    |   
   '-PLIB--(----+-libname---+-+--)-'   
                '-'libname'-'          

>--+---------------------------------+-------------------------->
   |          .-,---------------.    |   
   |          V                 |    |   
   '-LOPT--(------link-option---+--)-'   

>--+------------------------------+----------------------------->
   |         .-,-------------.    |   
   |         V               |    |   
   '-LIB--(----+-libname---+-+--)-'   
               '-'libname'-'          

>--+----------------------------------+------------------------->
   '-PMOD--(--+-prelink-object---+--)-'   
              '-'prelink-object'-'        

>--+--------------------------+--------------------------------->
   '-LOAD--(--+-module---+--)-'   
              '-'module'-'        

>--+-------------------------------+---------------------------->
   '-PMAP--(--+-prelink-map---+--)-'   
              '-'prelink-map'-'        

>--+---------------------------+-------------------------------->
   '-LIST--(--+-listing---+--)-'   
              '-'listing'-'        

>--+----------------------------------+------------------------><
   '-PDEF--(--+-prelink-object---+--)-'   
              '-'prelink-object'-'        

OBJ

You must always specify the input data set names on the OBJ keyword parameter. Each input data set must be a C/C++, COBOL, or assembler object module.

If the high-level qualifier of an object data set is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

POPT

Prelinker options can be specified using the POPT keyword parameter. If the MAP prelink option is specified, a prelink map will be written to the data set specified under the PMAP keyword parameter. For more details on generating a prelink map, see the description of the PMAP option.

LOPT

Linkage editor options can be specified using the LOPT keyword parameter. For details on how to generate a linkage editor listing, see the option LIST.

PLIB

The library names that are to be used by the automatic call library facility of the prelinker must be specified on the PLIB keyword parameter. The default library used is the C++ base library, CEE.SCEECPP.

The default library names are not added if library names are specified with the PLIB keyword parameter.

If the high-level qualifier of a library data set is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

LIB

If you want to specify libraries for the link-edit step to resolve external references, use the LIB keyword parameter. The default library used is the Language Environment library, CEE.SCEELKED.

The default library names are not added if library names are specified with the LIB keyword parameter.

If the high-level qualifier of a library data set is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

PMOD

If you want to keep the output prelinked object module, specify the data set it should be placed in using the PMOD keyword parameter. The default action is to create a temporary data set and erase it after the link-edit is complete.

If the high-level qualifier of the output prelinked object module is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

LOAD

To specify where the resultant load module should be placed, use the LOAD keyword parameter.

If the high-level qualifier of the load module is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

LIST

To specify where the linkage editor listing should be placed, use the LIST keyword parameter.

If the high-level qualifier of the linkage editor listing is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

PMAP

To specify where the prelinker map should be placed, use the PMAP keyword parameter.

If the high-level qualifier of the prelinker map is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.

PDEF

To specify where the generated IMPORT control statements should be placed by the prelinker.

If the high-level qualifier of the prelinker map is not the same as your user prefix, you must use the fully qualified name of the data set and place single quotation marks around the entire name.