PLIST
Category
Object code control
Pragma equivalent
None.
Purpose
Specifies that the original operating system parameter list should be available.
Defaults
PLIST(HOST)
Parameters
- HOST
- If you specify PLIST(HOST), the parameters are presented to main() as an argument list (argc, argv).
- OS
- If you specify PLIST(OS), the parameters are passed without restructuring, and the standard calling conventions of the operating system are used. See z/OS Language Environment Programming Guide for details on how to access these parameters.
Usage
When compiling main() programs, use the PLIST option to direct how the parameters from the caller are passed to main().
If you are compiling a main() program to run under IMS™, you must specify the PLIST(OS) and TARGET(IMS) options together.
If the METAL option is specified, the PLIST option is ignored.
IPA effects
If you specified PLIST for any compilation unit in the IPA compile step, it generates information for the IPA link step. This option also affects the regular object module if you request one by specifying the IPA(OBJECT) option.
If you specify PLIST for the IPA compile step, you do not need to specify it again on the IPA link step. The IPA link step uses the information generated for the compilation unit that contains the main() function, or for the first compilation unit it finds if it cannot find a compilation unit containing main().
If you specify this option on both the IPA Compile and the IPA link steps, the setting on the IPA link step overrides the setting on the IPA compile step. This situation occurs whether you use PLIST as a compiler option or specify it using the #pragma runopts directive (on the IPA compile step).
Predefined macros
None.
Related information
For more information on the TARGET compiler option, see TARGET.