PLIST

Pragma equivalent

None.

Purpose

Specifies that the original operating system parameter list should be available.

Syntax


            .-HOST-.     
>>-PLIST--(-+-OS---+-)-----------------------------------------><

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