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.