Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Migration Guide

Appendix C. Compiler option comparison

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.

Important

For complete descriptions of the Enterprise PL/I options, see the Enterprise PL/I for z/OS Programming Guide.

Table 15. Compiler option comparison
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.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)