- AGGREGATE
The AGGREGATE option creates an Aggregate Length Table that gives the lengths of arrays and major structures in the source program in the compiler listing. - ARCH
The ARCH option specifies the architecture for which the instructions of executable programs are to be generated. It allows the optimizer to take advantage of specific hardware instruction sets. 
ASSERT
The ASSERT option controls whether ASSERT statements call a default library routine that will raise the ASSERTION condition or a routine provided by the user.- ATTRIBUTES
The ATTRIBUTES option specifies that the compiler includes a table of source-program identifiers and their attributes in the compiler listing. - BACKREG
The BACKREG option controls the backchain register, which is the register used to pass the address of the automatic storage of a parent routine when a nested routine is invoked. - BIFPREC
The BIFPREC option controls the precision of the FIXED BIN result returned by various built-in functions. - BLANK
The BLANK option specifies up to ten alternate symbols for the blank character. - BLKOFF
The BLKOFF option controls whether the offsets shown in the pseudo-assembler listing (produced by the LIST option) and the statement offset listing (produced by the OFFSET option) are from the start of the current module or from the start of the current procedure. - BRACKETS
The BRACKETS option specifies the symbols that the SQL preprocessor accepts as the left and right brackets in SQL array references. - CASE
The CASE option controls whether some names will be shown in uppercase or in the same format as they appear in the source program. - CASERULES
The CASERULES option controls the enforcement of case rules for keywords. - CEESTART
The CEESTART option specifies whether the compiler should place the CEESTART csect before or after all the other generated object code. - CHECK
The CHECK option specifies whether the compiler should generate special code to detect various programming errors. - CMPAT
The CMPAT option specifies whether object compatibility with OS PL/I Version 1, OS PL/I Version 2, PL/I for MVS™ & VM, or Enterprise PL/I for z/OS is to be maintained for programs sharing strings, AREAs, arrays, or structures. - CODEPAGE
The CODEPAGE option specifies the code page used for conversions between CHARACTER and WIDECHAR. The option also specifies the default code page used by the PLISAX built-in subroutines. - COMMON
The COMMON option directs the compiler to generate CM linkage records for EXTERNAL STATIC variables. - COMPILE
The COMPILE option causes the compiler to stop compiling after all semantic checking of the source program if it produces a message of a specified severity during preprocessing or semantic checking. - COPYRIGHT
The COPYRIGHT option places a string in the object module, if generated. This string is loaded into memory with any load module into which this object is linked. - CSECT
The CSECT option ensures that the object module, if generated, contains named CSECTs. - CSECTCUT
The CSECTCUT option controls how the compiler, when processing the CSECT option, handles long names. - CURRENCY
The CURRENCY option allows you to specify an alternate character to be used in picture strings instead of the dollar sign. - DBCS
The DBCS option ensures that the listing, if generated, is sensitive to the possible presence of DBCS even though the GRAPHIC option has not been specified. - DD
Using the DD option, you can specify alternate DD names for the various data sets used by the compiler. - DDSQL
Using the DDSQL option, you can specify an alternate DD name for the data set that is used by the SQL preprocessor when the preprocessor resolves EXEC SQL INCLUDE statements. - DECIMAL
The DECIMAL option specifies how the compiler should handle certain FIXED DECIMAL operations and assignments. - DECOMP
The DECOMP option instructs the compiler to generate a listing section that gives a decomposition of expressions used in the compilation. - DEFAULT
The DEFAULT option specifies defaults for attributes and options. These defaults are applied only when the attributes or options are not specified or implied in the source code. - DEPRECATE
This option flags variable names, included file names, and statement names that you want to deprecate with error messages. - DEPRECATENEXT
The purpose and usage of the DEPRECATENEXT option are the same as the DEPRECATE option, except that the compiler issues warning messages rather than error messages for items that you will deprecate in a future development phase. - DISPLAY
The DISPLAY option determines how the DISPLAY statement performs I/O. - DLLINIT
The DLLINIT option applies OPTIONS(FETCHABLE) to all external procedures that are not MAIN. Use this option only on compilation units containing one external procedure, and then that procedure should be linked as a DLL. - EXIT
The EXIT option enables the compiler user exit to be invoked. - EXPORTALL
The EXPORTALL option controls whether to export all externally defined procedures and variable so that a DLL application can use them. - EXTRN
The EXTRN option controls when EXTRNs are emitted for external entry constants. - FILEREF
The (NO)FILEREF option controls whether the compiler produces a file reference table. The NOFILEREF option eliminates the file reference table from the listing if the compiler issues no messages for the specified FLAG setting. - FLAG
The FLAG option specifies the minimum severity of error that requires a message listed in the compiler listing. - FLOAT
The FLOAT option controls the use of the additional floating-point registers and whether Decimal Floating Point is supported. - FLOATINMATH
The FLOATINMATH option specifies that the precision that the compiler should use when invoking the mathematical built-in functions. - GOFF
The GOFF option instructs the compiler to produce an object file in the Generalized Object File Format (GOFF). - GONUMBER
The GONUMBER option specifies that the compiler produces additional information that allows line numbers from the source program to be included in runtime messages. - GRAPHIC
The GRAPHIC option specifies that the source program can contain double-byte characters. - HEADER
The HEADER option lets you control what appears in the middle of each header line in the compiler listing. - IGNORE
The IGNORE option controls whether ASSERT, DISPLAY, and PUT statements are ignored. When a statement is ignored, it is as if the statement is replaced by a semicolon. - INCAFTER
The INCAFTER option specifies a file to be included after a particular statement in your source program. - INCDIR
The INCDIR compiler option specifies a directory to be added to the search path used to locate include files. - INCLUDE
The INCLUDE compiler option controls whether the final pass of the compiler handles %INCLUDE and %XINCLUDE statements. - INCPDS
The INCPDS option specifies a PDS from which the compiler will include files when compiling a program under z/OS UNIX. - INITAUTO
The INITAUTO option directs the compiler to add an INITIAL attribute to any AUTOMATIC variable declared without an INITIAL attribute. - INITBASED
The INITBASED option directs the compiler to add an INITIAL attribute to any BASED variable declared without an INITIAL attribute. - INITCTL
The INITCTL option directs the compiler to add an INITIAL attribute to any CONTROLLED variable declared without an INITIAL attribute. - INITSTATIC
The INITSTATIC option directs the compiler to add an INITIAL attribute to any STATIC variable declared without an INITIAL attribute. - INSOURCE
The INSOURCE option specifies that the compiler should include a listing of the source program before the PL/I macro, CICS®, or SQL preprocessors translate it. - INTERRUPT
The INTERRUPT option causes the compiled program to respond to attention requests (interrupts). - JSON
Using the JSON option, you can choose the case of the names in the JSON text generated by the JSONPUT built-in functions and expected by the JSONGET built-in functions. - LANGLVL
The LANGLVL option specifies the level of PL/I language definition that you want the compiler to accept. - LIMITS
The LIMITS option specifies various implementation limits. - LINECOUNT
The LINECOUNT option specifies the number of lines per page for compiler listings, including blank and heading lines. - LINEDIR
The LINEDIR option specifies that the compiler should accept %LINE directives. - LIST
The LIST option specifies that the compiler should produce a pseudo-assembler listing. - LISTVIEW
The LISTVIEW option 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. - LP
The LP option specifies whether the compiler generates 31-bit code or 64-bit code. It also determines the default size of POINTER and HANDLE and related variables. - MACRO
The MACRO option invokes the MACRO preprocessor. - MAP
The MAP option specifies that the compiler produces additional information that can be used to locate static and automatic variables in dumps. - MARGINI
The MARGINI option specifies a character that the compiler will place 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
The MARGINS option specifies which part of each compiler input record contains PL/I statements, and the position of the ANS control character that formats the listing, if the SOURCE option, the INSOURCE option, or both apply. The compiler does not process data that is outside these limits, but it does include it in the source listings. - MAXBRANCH
The MAXBRANCH option flags blocks that have too many branches. Branches include all conditional jumps and each WHEN in a SELECT statement that can be turned into a branch table. - MAXGEN
The MAXGEN option specifies the maximum number of intermediate language statements that should be generated for any user statement. The option will cause the compiler to flag any statement where this maximum is exceeded. - MAXMEM
When you compile with OPTIMIZE, the MAXMEM option limits the amount of memory used for local tables of specific, memory-intensive optimizations to the specified number of kilobytes. - MAXMSG
The MAXMSG option specifies the maximum number of messages with a given severity (or higher) that the compilation should produce. - MAXNEST
The MAXNEST option specifies the maximum nesting of various kinds of statements that are allowed before the compiler flags your program as too complex. - MAXSTMT
The MAXSTMT option controls the compiler to flag blocks that have a larger number of statements than a specified number. In addition, under OPT(2), the compiler will turn off optimization for any block that has more than the specified number of statements. Under OPT(3), the compiler will not turn off optimization when a block has too many statements though the compile time might much greater when the MAXSTMT limit is exceeded. - MAXTEMP
The MAXTEMP option determines when the compiler flags statements that are using an excessive amount of storage for compiler-generated temporaries. - MDECK
The MDECK option specifies that the preprocessor produces a copy of its output either on the file defined by the SYSPUNCH DD statement under z/OS or on the .dek file under z/OS UNIX. - MSGSUMMARY
The MSGSUMMARY option determines whether the compiler adds a summary of all messages that are issued during compilation into the listing. - NAME
The NAME option specifies that the TEXT file created by the compiler will contain a NAME record. - NAMES
The NAMES option specifies the extralingual characters that are allowed in identifiers. - NATLANG
The NATLANG option specifies the language for compiler messages, headers, and so on. - NEST
The NEST option specifies that the listing resulting from the SOURCE option indicates the block level and the do-group level for each statement. - NOT
The NOT option specifies up to seven alternate symbols that can be used as the logical NOT operator. - NULLDATE
The NULLDATE option instructs the compiler to accept the SQL null date as a valid date in some datetime handling built-in functions. - NUMBER
The NUMBER option specifies that statements in the source program are to be identified by the line and file number of the file from which they derived, and that this pair of numbers is used to identify statements in the compiler listings resulting from the AGGREGATE, ATTRIBUTES, LIST, MAP, OFFSET, SOURCE, and XREF options. - OBJECT
The OBJECT option specifies that the compiler creates an object module. Under batch z/OS, the compiler stores the object in the data set defined by the SYSLIN DD, and underz/OS UNIX, the compiler creates a .o file. - OFFSET
The OFFSET option 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. This table can be used to identify a statement from a runtime error message if the GONUMBER option is not used. - OFFSETSIZE
The OFFSETSIZE option determines the size of OFFSET variables in 64-bit applications. - ONSNAP
For a PROCEDURE with either the OPTIONS(MAIN) or the OPTIONS(FROMALIEN) attribute, the ONSNAP option specifies that the compiler should insert an ON STRINGRANGE SNAP; statement, an ON STRINGSIZE SNAP; statement, or both into the prologue code for that PROCEDURE. This can make it easier to determine the calling chain if the corresponding conditions are raised in other routines called from such a PROCEDURE. - OPTIMIZE
The OPTIMIZE option specifies the type of optimization required. - OPTIONS
The OPTIONS option specifies that the compiler includes a list showing the compiler options to be used during this compilation in the compiler listing. - OR
The OR option specifies up to seven alternate symbols as the logical OR operator. These symbols are also used as the concatenation operator, which is defined as two consecutive logical OR symbols. - PP
The PP option specifies which (and in what order) preprocessors are invoked before compilation. - PPCICS
The PPCICS option specifies options to be passed to the CICS preprocessor if it is invoked. - PPINCLUDE
The PPINCLUDE option specifies options to be passed to the INCLUDE preprocessor if it is invoked. - PPLIST
The PPLIST option controls whether the compiler keeps or erases the part of the listing that is generated by each preprocessor phase. - PPMACRO
The PPMACRO option specifies options to be passed to the MACRO preprocessor if it is invoked. - PPSQL
The PPSQL option specifies options to be passed to the SQL preprocessor. - PPTRACE
The PPTRACE option 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. The directive indicates the original source file and line to which the nonblank line should be attributed. - PRECTYPE
The PRECTYPE option 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
The PREFIX option enables or disables the specified PL/I conditions in the compilation unit being compiled without you having to change the source program. The specified condition prefixes are logically prefixed to the beginning of the first PACKAGE or PROCEDURE statement. - PROCEED
The PROCEED option stops the compiler after processing by a preprocessor is completed depending on the severity of messages issued by previous preprocessors. - PROCESS
The PROCESS option determines whether *PROCESS statements are allowed and, if they are allowed, whether they are written to the MDECK file. - QUOTE
The QUOTE option specifies an alternate symbol that can be used as the quote character. - REDUCE
The REDUCE option specifies that the compiler is permitted to reduce an assignment of a null string to a structure into simpler operations - even if that means padding bytes might be overwritten. - RENT
Your code is "naturally reentrant" if it does not alter any of its static variables. The RENT option specifies that the compiler is to take code that is not naturally reentrant and make it reentrant. - RESEXP
The RESEXP option specifies that the compiler is permitted to evaluate all restricted expressions at compile time even if this would cause a condition to be raised and the compilation to end with S-level messages. - RESPECT
The RESPECT option 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. - RTCHECK
The RTCHECK option specifies that extra code is generated to force the ERROR condition to be raised if a null pointer is dereferenced, that is, if the pointer is used to change or obtain the value of a variable. - RULES
The RULES option allows or disallows certain language capabilities and lets you choose semantics when alternatives are available. It can help you diagnose common programming errors. - SEMANTIC
The SEMANTIC option specifies that the execution of the semantic checking stage depends on the severity of messages issued before this stage of processing. - SERVICE
The SERVICE option places a string in the object module, if generated. This string is loaded into memory with any load module into which this object is linked, and if the LE dump includes a traceback, this string will be included in that traceback. - SOURCE
The SOURCE option specifies that the compiler includes a listing of the source program in the compiler listing. The source program listed is either the original source input or, if any preprocessors were used, the output from the last preprocessor. - SPILL
The SPILL option specifies the size of the spill area to be used for the compilation. When too many registers are in use at once, the compiler dumps some of the registers into temporary storage that is called the spill area. - STATIC
The STATIC option controls whether INTERNAL STATIC variables are retained in the object module even if unreferenced. - STDSYS
The STDSYS option specifies that the compiler should cause the SYSPRINT file to be equated to the C stdout file and the SYSIN file to be equated to the C stdin file. - STMT
The STMT option specifies that statements in the source program are to be counted and that this statement number is used to identify statements in the compiler listings resulting from the AGGREGATE, ATTRIBUTES, SOURCE, and XREF options. - STORAGE
The STORAGE option directs the compiler to produce as part of the listing a summary of the storage used by each procedure and begin-block. - STRINGOFGRAPHIC
The STRINGOFGRAPHIC option determines whether the result of the STRING built-in function when applied to a GRAPHIC aggregate has the attribute CHARACTER or GRAPHIC. - SYNTAX
The SYNTAX option specifies that the compiler continues into syntax checking after preprocessing when you specify the MACRO option, unless an unrecoverable error has occurred. Whether the compiler continues with the compilation depends on the severity of the error, as specified by the NOSYNTAX option. - SYSPARM
The SYSPARM option specifies the value of the string that is returned by the macro facility built-in function SYSPARM. - SYSTEM
The SYSTEM option 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
The TERMINAL option determines whether diagnostic and information messages produced during compilation are displayed on the terminal. - TEST
The TEST option specifies the level of testing capability that the compiler generates as part of the object code. You can use this option to control the location of test hooks and to control whether to generate a symbol table. - UNROLL
The UNROLL option controls loop unrolling under optimization. Loop unrolling is an optimization that replicates a loop body multiple times and adjusts the loop control code accordingly. - USAGE
Using the USAGE option, you can choose different semantics for selected built-in functions. - WIDECHAR
The WIDECHAR option specifies the format in which WIDECHAR data will be stored. - WINDOW
The WINDOW option sets the value for the w window argument used in various date-related built-in functions. - WRITABLE
The WRITABLE option specifies that the compiler can treat static storage as writable (and if it does, this will make the resultant code nonreentrant). - XINFO
The XINFO option specifies that the compiler should generate additional files with extra information about the current compilation unit. - XML
The XML option specifies the case of the names in the XML generated by the XMLCHAR built-in function. - XREF
The XREF option provides a cross-reference table of names used in the program together with the numbers of the statements in which they are declared or referenced in the compiler listing.
Parent topic: Using compiler options and facilities