This appendix briefly describes which compiler options are available in the OS PL/I PL/I for MVS & VM, VisualAge PL/I and Enterprise PL/I compilers.
For complete descriptions of the Enterprise PL/I options, see the Enterprise PL/I for z/OS Programming Guide.
|
Option |
Available in | Abbreviated option description | |||
|---|---|---|---|---|---|
| OS PL/I | PL/I for MVS & VM | VisualAge PL/I | Enterprise PL/I | ||
|
AGGREGATE NOAGGREGATE |
X | X | X | X | Creates an aggregate length table that gives the lengths of arrays and major structures. |
|
ARCH |
X | X | Specifies the architecture for which the executable program's instructions are to be generated. | ||
|
ATTRIBUTES NOATTRIBUTES |
X | X | X | X | Specifies that the compiler includes a table of source-program identifiers and their attributes in the compiler listing. |
|
BACKREG |
X | Controls the backchain register | |||
|
BIFPREC |
X | Controls the precision of the FIXED BIN result returned by various built-in functions. | |||
|
BLANK |
X | Specifies up to ten alternate symbols for the blank character. | |||
|
BLKOFF NOBLKOFF |
X | Controls whether the offsets shown in the psuedo-assembler listing are from the start of the current module or from the start of the current procedure. | |||
| CEESTART | X | Specifies whether the compiler should place the CEESTART csect before or after all of the other generated object code. | |||
|
CHECK |
X | X | Alters the behavior of the ALLOCATE and FREE statements. | ||
|
CMPAT |
X | X | X | X | Controls object compatibility between releases of PL/I. |
|
CODEPAGE |
X | Specifies the code page used for conversions between CHARACTER and WIDECHAR and used by the PLISAX built-in subroutines. | |||
| COMMON | X | Directs the compiler to generate CM linkage records for EXTERNAL STATIC variables. | |||
|
COMPACT |
X | Influences the size and speed of code that the compiler generates. | |||
|
COMPILE NOCOMPILE |
X | X | X | X | Controls whether the compiler stops or continues when it produces a message of the specified severity. |
|
COPYRIGHT NOCOPYRIGHT |
X | Places a string in the object module, if generated. | |||
|
CSECT NOCSECT |
X | X | Controls the generation of named CSECTs. | ||
|
CSECTCUT |
X | Controls how the compiler, when processing the CSECT option, handles long names. | |||
|
CONTROL |
X | X | Specifies that any compile-time options deleted for your installation are available for this compilation. | ||
|
CURRENCY |
X | X | Allows you to specify an alternate character for the dollar sign. | ||
|
DBCS NODBCS |
X | Ensures that the listing, if generated, is sensitive to the possible presence of DBCS even though the GRAPHIC options has not been specified. | |||
|
DD |
X | X | Allows you to specify alternate DD names for the compiler listing, the primary source file, the default include dataset and the MDECK dataset. | ||
|
DDSQL |
X | Allows you to specify alternate DD names for the dataset to be used by the SQL preprocessor when resolving EXEC SQL INCLUDE statements. | |||
| DECIMAL | X | Specifies how the compiler should handle certain FIXED DECIMAL operations and assignments. | |||
|
DECK NODECK |
X | X | Specifies that the compiler produces an object module in the form of 80-character records and store it in the SYSPUNCH dataset. | ||
|
DEFAULT |
X | X | Specifies defaults for attributes. | ||
|
DISPLAY |
X | X | Determines where output of the DISPLAY statement is directed. | ||
|
DLLINIT NODLLINIT |
X | X | Applies OPTIONS(FETCHABLE) to all external procedures that are not MAIN. | ||
|
ESD NOESD |
X | X | Specifies that the external symbol dictionary (ESD) is listed in the compiler listing. | ||
|
EXIT NOEXIT |
X | X | Enables the compiler user exit to be invoked. | ||
|
EXTRN |
X | X | Controls when EXTRNs are emitted for external entry constants. | ||
|
FLAG |
X | X | X | X | Specifies the minimum severity of error that requires a message listed in the compiler listing. |
|
FLOAT |
X | X | Controls the use of additional floating-point registers. | ||
|
FLOATINMATH |
X | Specifies the precision that the compiler should use when invoking the mathematical built-in functions. | |||
|
GOFF NOGOFF |
X | Instructs the compiler to produce an object file in the Generalized Object File Format. | |||
|
GONUMBER NOGONUMBER |
X | X | X | X | Specifies that the compiler produces additional information that allows line numbers for the source program to be included in run-time messages. |
|
GOSTMT NOGOSTMT |
X | X | Specifies that the compiler produces additional information that allows statement numbers for the source program to be included in run-time messages. | ||
|
GRAPHIC NOGRAPHIC |
X | X | X | X | Specifies that the source program can contain double-byte characters. |
|
HGPR NOHGPR |
X | Specifies that the compiler is permitted to exploit 64-bit General Purpose Registers (GPRs) in 32-bit programs targeting z/Architecture hardware. | |||
|
IMPRECISE NOIMPRECISE |
X | X | Specifies that the compiler includes extra text in the object module to localize imprecise interrupts when executing the program with an IBM System/390 Model 165 or 195. | ||
|
INCAFTER |
X | X | Specifies a file to be included after a particular statement in your source program. | ||
|
INCDIR |
X | X | Includes a directory in the search path for the location of include files. | ||
|
INCLUDE |
X | X | X | Specifies the file name extensions under which include files are searched. | |
| INCPDS | X | Specifies a PDS from which the compiler will include files when compiling a program under z/OS UNIX. | |||
| INITAUTO | X | Directs the compiler to add an INITIAL attribute to any AUTOMATIC variable declared without an INITIAL attribute. | |||
| INITBASED | X | Directs the compiler to add an INITIAL attribute to any BASED variable declared without an INITIAL attribute. | |||
| INITCTL | X | Directs the compiler to add an INITIAL attribute to any CONTROLLED variable declared without an INITIAL attribute. | |||
| INITSTATIC | X | Directs the compiler to add an INITIAL attribute to any STATIC variable declared without an INITIAL attribute. | |||
|
INSOURCE NOINSOURCE |
X | X | X | X | Specifies that the compiler should include a listing of the source program before the PL/I macro preprocessor translates it. |
|
INTERRUPT NOINTERRUPT |
X | X | X | X | Causes the compiled program to respond to attention requests (interrupts). |
|
LANGLVL |
X | X | X | X | Specifies the level of PL/I language definition that you want the compiler to accept. |
|
LIMITS |
X | X | Specifies implementation limits for EXTERNAL name, FIXED DECIMAL, SIGNED FIXED BINARY, and NAME in your source program. | ||
|
LINECOUNT |
X | X | X | X | Specifies the number of lines per page for compiler listings, including blank and heading lines. |
|
LINEDIR NOLINEDIR |
X | Specifies that the compiler should accept &LINE directives. | |||
|
LIST NOLIST |
X | X | X | X | Provides a psuedo-assembler listing. |
|
LISTVIEW |
X | Specifies whether the compiler should show the source in the source listing or whether it should show the source after it has been processed by one or more of the preprocessors. | |||
|
LMESSAGE SMESSAGE |
X | X | Produce messages in a long form (specify LMESSAGE) or in a short form (specify SMESSAGE). | ||
|
MACRO NOMACRO |
X | X | X | X | Invokes the MACRO preprocessor. |
|
MAP NOMAP |
X | X | X | X | Specifies that the compiler produces additional information that can be used to locate static and automatic variables in dumps. |
|
MARGINI NOMARGINI |
X | X | X | X | Provides a specified character in the column preceding the left-hand margin, and also in the column following the right-hand margin, of the listings produced by the INSOURCE and SOURCE options. |
|
MARGINS |
X | X | X | X | Specifies which part of each compiler input record contains PL/I statements, and the position of the ANS control character that formats the listing. |
|
MAXMEM |
X | X | When compiling with OPTIMIZE, this option limits the amount of memory used for local tables of specific, memory intensive optimizations to the specified number of kilobytes. | ||
|
MAXMSG |
X | Specifies the maximum number of messages with a given severity (or higher) that the compilation should produce. | |||
|
MAXNEST |
X | Specifies the maximum nesting of various kinds of statements that should be allowed before the compiler flags your program as too complex. | |||
|
MAXSTMT |
X | Under the MAXSTMT option, optimization will be turned off for any block that has more than the specified number of statements. | |||
|
MAXTEMP |
X | Determines when the compiler flags statements using an excessive amount of storage for compiler-generated temporaries. | |||
|
MDECK NOMDECK |
X | X | X | X | Specifies that the preprocessor produces a copy of its output. |
|
NAMES |
X | X | Specifies the extralingual characters that are allowed in identifiers. | ||
|
NAME NONAME |
X | X | X | X | Specifies that the TEXT file created by the compiler will contain a NAME record. |
|
NATLANG |
X | Specifies the "language" for compiler messages, headers, etc. | |||
|
NEST NONEST |
X | X | X | X | Specifies that the listing resulting from the SOURCE option indicates the block level and the do-group level for each statement. |
|
NOT |
X | X | X | Specifies up to seven alternate symbols that can be used as the logical NOT operator. | |
|
NUMBER NONUMBER |
X | X | X | X | Specifies that statements in the source program are to be identified by the line and file number of the file from which they derived. |
|
OBJECT NOOBJECT |
X | X | X | X | Specifies that the compiler creates an object module. |
|
OFFSET NOOFFSET |
X | X | X | Specifies that the compiler is to print a table of line numbers for each procedure and BEGIN block with their offset addresses relative to the primary entry point of the procedure. | |
|
OPTIMIZE NOOPTIMIZE |
X | X | X | X | Specifies the type of optimization required. |
|
OPTIONS NOOPTIONS |
X | X | X | X | Specifies that the compiler includes a list showing the compile-time options to be used during this compilation in the compiler listing. |
|
OR |
X | X | X | Specifies up to seven alternate symbols as the logical OR operator. | |
|
PP NOPP |
X | X | Specifies which (and in what order) preprocessors are invoked prior to compilation. | ||
|
PPCICS NOPPCICS |
X | Specifies options to be passed to the CICS preprocessor if it is invoked. | |||
|
PPINCLUDE NOPPINCLUDE |
X | Specifies options to be passed to the INCLUDE preprocessor if it is invoked. | |||
|
PPMACRO NOPPMACRO |
X | Specifies options to be passed to the MACRO preprocessor if it is invoked. | |||
|
PPSQL NOPPSQL |
X | Specifies options to be passed to the SQL preprocessor if it is invoked. | |||
|
PPTRACE NOPPTRACE |
X | X | Specifies that, when a deck file is written for a preprocessor, every nonblank line in that file is preceded by a line containing a %LINE directive. | ||
| PRECTYPE | X | Determines how the compiler derives the attributes for the MULTIPLY, DIVIDE, ADD and SUBTRACT built-in functions when the operands are FIXED and at least one is FIXED BIN. | |||
|
PREFIX |
X | X | Enables or disables the specified PL/I conditions in the compilation unit being compiled without you having to changed the source program. | ||
|
PROCEED NOPROCEED |
X | X | Stops the compiler after processing by a preprocessor is completed depending on the severity of messages issued by previous preprocessors. | ||
| PROCESS | X | Determines if *PROCESS statements are allowed and, if they are allowed, if they are written to the MDECK file. | |||
|
QUOTE |
X | Specifies up to seven alternate symbols that can be used as the quote character. | |||
|
REDUCE NOREDUCE |
X | Specifies that the compiler is permitted to reduce an assignment of a null string to a structure into a simple copy operation - even if that means padding bytes might be overwritten. | |||
|
RENT NORENT |
X | X | Specifies that the compiler is to take code that is not naturally reentrant and make it reentrant. compiler listing. | ||
|
RESEXP NORESEXP |
X | Controls whether the compiler is permitted to evaluate all restricted expressions at compile-time. | |||
|
RESPECT |
X | X | Causes the compiler to honor any specification of the DATE attribute and to apply the DATE attribute to the result of the DATE built-in function. | ||
|
RULES |
X | X | Allows certain language capabilities and lets you choose semantics when alternatives are available. | ||
|
SEMANTIC NOSEMANTIC |
X | X | Specifies that the execution of the compiler's semantic checking stage depends on the severity of messages issued prior to this stage of processing. | ||
|
SEQUENCE NOSEQUENCE |
X | X | Defines the section of the input record from which the compiler takes the sequence numbers. | ||
|
SERVICE NOSERVICE |
X | Places a string in the object module, if generated. | |||
|
SIZE |
X | X | Limits the amount of main storage the compiler uses. | ||
|
SOURCE NOSOURCE |
X | X | X | X | Specifies that the compiler includes a listing of the source program in the compiler listing. |
|
SPILL |
X | Specifies the size of the spill area to be used for the compilation. | |||
|
STATIC |
X | Controls whether INTERNAL STATIC variables are retained in the object module even if unreferenced. | |||
|
STDSYS NOSTDSYS |
X | Specifies that the compiler should cause the SYSPRINT file to be equated to the C stdout file. | |||
|
STMT NOSTMT |
X | X | X | Specifies that statements in the source program are to be counted and that this "statement number" is used to identify statements in the compiler listing. | |
|
STORAGE NOSTORAGE |
X | X | X | X | Determines whether or not the compiler produces a report in the listing that gives the approximate amount of stack storage used by each block in your program. |
| STRINGOFGRAPHIC | X | Determines whether the result of the STRING built-in function when applied to a GRAPHIC aggregate has the attribute CHARACTER or GRAPHIC. | |||
|
SYNTAX NOSYNTAX |
X | X | X | X | Specifies that the compiler continues into syntax checking after preprocessing. |
|
SYSPARM |
X | X | Allows you to specify the value of the string that is returned by the macro facility built-in function SYSPARM. | ||
|
SYSTEM |
X | X | X | X | Specifies the format used to pass parameters to the MAIN PL/I procedure, and generally indicates the host system under which the program runs. |
|
TERMINAL NOTERMINAL |
X | X | X | X | Determines whether or not diagnostic and information messages produced during compilation are displayed on the terminal. |
|
TEST NOTEST |
X | X | X | X | Specifies the level of testing capability that the compiler generates as part of the object code. |
|
TUNE |
X | X | Specifies the architecture for which the executable program will be optimized. | ||
|
USAGE |
X | Lets you choose IBM or ANS semantics for the ROUND and UNSPEC built-in functions. | |||
|
WIDECHAR |
X | X | Specifies the format in which WIDECHAR data will be stored. | ||
|
WINDOW |
X | X | Sets the value for the window argument used in various date-related built-in functions. | ||
|
WRITABLE NOWRITABLE |
X | Specifies that the compiler may treat static storage as writable. | |||
|
XINFO |
X | X | Specifies that the compiler should generate additional files with extra information about the current compilation unit. | ||
|
XML |
X | Allows the choice of the case of the names in the XML generated by the XMLCHAR built-in function. | |||
|
XREF NOXREF |
X | X | X | X | Provides a cross-reference table of names used in the program. |