Derivation: Parameter LIST
PLIST
specifies the format of the invocation parameters your
C application
receives when you invoke it. Although the CICS®, CMS, IMS™, MVS™, and TSO suboptions of PLIST
are supported for compatibility, you should use the HOST or OS suboptions
of PLIST. Before using this runtime option, you should review the
following restrictions:
- This option does not apply to non-C languages
and can be specified only with the C #pragma
runopts directive.
- You cannot set this option at the system level, region
level, or in the CEEBXITA assembler user exit interface.
The default value for non-CICS applications is PLIST(HOST).
PLIST
is ignored under CICS.
Syntax
.-HOST-.
>>-PLIST--(--+-CICS-+--)---------------------------------------><
+-CMS--+
+-IMS--+
+-MVS--+
+-OS---+
'-TSO--'
- HOST
- The parameter list is a character string. The string is located
differently under various systems, as follows:
- CMS
- If invoked by OSRUN, use the string presented in an MVS-like format
located by the pointer held in R1. If not invoked by OSRUN, use the
CMS extended parameter list.
- TSO
- If a command processor parameter list (CPPL) is detected, get
the string from the command buffer. If a CPPL is not detected, assume
a halfword-prefixed string in the MVS format.
- MVS
- Use the halfword-prefixed string.
- CICS
- The parameter list received by your C application
is assumed to be in a CICS format.
- CMS
- The parameter list received by your C application
is assumed to be in a CMS extended parameter list format.
- IMS
- The parameter list received by your C application
is assumed to be in an IMS format.
- MVS
- The parameter list received by your C application
is assumed to be in an MVS format.
- OS
- The parameter list received by your C application
is assumed to be in an OS style.
- TSO
- The parameter list received by your C application
is assumed to be in a CPPL format.
Usage notes
- The behavior of C applications
with PLIST(HOST) in effect is the same for C++.
- When using the pre-Language Environment-conforming C interface
for preinitialization, it is necessary to specify PLIST(MVS) in order to flag preinitialized routines.
- IMS considerations—If your
C application runs under IMS,
the suboption of PLIST that you specify depends on the version of
the C compiler
you used. If you compiled your application with Version 2.1 (or earlier)
of the C compiler,
specify the PLIST(IMS) suboption.
If your C++ application
runs under IMS, you should specify
the z/OS XL C++ compiler
option PLIST(OS).
- z/OS UNIX consideration—The
PLIST option applies only to the main routine of the initial thread.