Rational Developer for System z
PL/I for Windows, Version 7.6, Programming Guide

Compile-time option descriptions

There are three types of compiler options; however, most compiler options have a positive and negative form. The negative form is the positive with 'NO' added at the beginning (as in TEST and NOTEST). Some options have only a positive form (as in SYSTEM). The three types of compiler options are:

  1. Simple pairs of keywords: a positive form that requests a facility, and an alternative negative form that inhibits that facility (for example, NEST and NONEST).
  2. Keywords that allow you to provide a value list that qualifies the option (for example, FLAG(W)).
  3. A combination of 1 and 2 above (for example, NOCOMPILE(E)).

Table 2 lists all the compiler options with their abbreviations (if any) and their IBM-supplied default values. If an option has any suboptions which may be abbreviated, those abbreviations are described in the full description of the option.

For the sake of brevity, some of the options are described loosely in the table (for example, only one suboption of LANGLVL is mandatory, and similarly, if you specify one suboption of TEST, you do not have to specify the other). The full and completely accurate syntax is described in the pages that follow.

The paragraphs following Table 2 describe the options in alphabetical order. For those options specifying that the compiler is to list information, only a brief description is included; the generated listing is described under Using the compiler listing.

Table 2. Compile-time options, abbreviations, and IBM-supplied defaults
Compile-Time Option
Abbreviated Name
Windows Default
ADDEXT | NOADDEXT
-
ADDEXT
AGGREGATE ( DECIMAL | HEXADEC )| NOAGGREGATE
AG | NAG
NOAGGREGATE
ATTRIBUTES[(FULL|SHORT)] |
  NOATTRIBUTES
A | NA
NA [(FULL)]1
BIFPREC( 15 | 31 )
-
BIFPREC(31)
BLANK('c')
-
BLANK('t')2
CHECK(STORAGE | NOSTORAGE,
  CONFORMANCE | NOCONFORMANCE)
-
CHECK(NSTG,
NOCONFORMANCE)
CMPAT(LE | V1 | V2)
-
CMPAT(V2)
CODEPAGE(n)
CP
CODEPAGE(00819)
COMPILE | NOCOMPILE[(W | E | S)]
C | NC
NOCOMPILE(S)
COPYRIGHT(’string’ ) | NOCOPYRIGHT
-
NOCOPYRIGHT
CURRENCY('c')
CURR
CURRENCY($)
NODBCS | DBCS(JPN | CHS | CHT | KOR)
-
NODBCS
DEFAULT(attribute | option)
DFT
See page DEFAULT
DLLINIT | NODLLINIT
-
NODLLINIT
EXIT | NOEXIT
-
NOEXIT
EXTRN(FULL | SHORT)
-
EXTRN(FULL)
FLAG[(I | W | E | S)]
F
FLAG(W)
FLOATINMATH( ASIS | LONG | EXTENDED )
-
FLOATINMATH( ASIS )
GONUMBER | NOGONUMBER
GN | NGN
NOGONUMBER
GRAPHIC | NOGRAPHIC
GR | NGR
NOGRAPHIC
IMPRECISE | NOIMPRECISE
-
IMPRECISE
INCAFTER([PROCESS(filename)])
-
INCAFTER()
INCDIR('directory name')
-
INCDIR()
INCLUDE[(EXT('include extension'))]
INC
INC(EXT('inc'))
INITAUTO | NOINITAUTO
-
NOINITAUTO
INITBASED | NOINITBASED
-
NOINITBASED
INITCTL | NOINITCTL
-
NOINITCTL
INITSTATIC | NOINITSTATIC
-
NOINITSTATIC
INSOURCE[(FULL|SHORT)] | NOINSOURCE
IS | NIS
NOINSOURCE
LANGLVL(SAA | SAA2[,NOEXT | OS])
-
LANGLVL(SAA2,OS)
LIBS
-
See page  LIBS
LIMITS(options)
-
See page LIMITS
LINECOUNT(n)
LC
LINECOUNT(60)
LINEDIR | NOLINEDIR
-
NOLINEDIR
LIST | NOLIST
-
NOLIST
LISTVIEW( SOURCE | AFTERMACRO
| AFTERCICS | AFTERSQL | AFTERALL )
-
LISTVIEW(SOURCE)
MACRO | NOMACRO
M | NM
NOMACRO
MARGINI('c') | NOMARGINI
MI | NMI
NOMARGINI
MARGINS(m,n[,c])| NOMARGINS
MAR(m,n)
MARGINS
F-format: (2,72)
V-format: (10,100)
MAXGEN(n)
-
MAXGEN(100000)
MAXMSG(I | W | E | S,n)
-
MAXMSG(W,250)
MAXNEST( BLOCK(x) DO(y) IF(z) )
-
MAXNEST( BLOCK(17)
DO(17) IF(17) )
MAXSTMT(n)
-
MAXSTMT(4096)
MAXTEMP(n)
-
MAXTEMP(1000)
MDECK | NOMDECK
MD | NMD
NOMDECK
MSG( 390 | * )
-
MSG(* )
NAMES('lower'[,upper])
-
NAMES('#@$','#@$')
NATLANG(ENU | CHS | CHT | DEU | ESP |
         FRA | JPN | PTB )
-
NATLANG(ENU)
NEST | NONEST
-
NONEST
NOT
-
NOT('¬')
NUMBER | NONUMBER
NUM | NNUM
NUMBER
OBJECT | NOOBJECT
OBJ | NOBJ
OBJECT
OFFSET | NOOFFSET
OF | NOF
NOOFFSET
ONSNAP( STRINRANGE | STRINGSIZE ) | NOONSNAP
-
NOONSNAP
OPTIMIZE(  0 | 2  |  3  ) | NOOPTIMIZE
OPT | NOPT
OPT(0)
OPTIONS[(ALL|DOC)] | NOOPTIONS
OP | NOP
NOOPTIONS
OR('c')
-
OR(' | ')
PP(pp-name) | NOPP
-
NOPP
PPCICS(’string’ ) | NOPPCICS
-
NOPPCICS
PPINCLUDE(’string’ ) | NOPPINCLUDE
-
NOPPINCLUDE
PPMACRO(’string’ ) | NOPPMACRO
-
NOPPMACRO
PPSQL(’string’ ) | NOPPSQL
-
NOPPSQL
PPTRACE | NOPPTRACE
-
NOPPTRACE
PRECTYPE ( ANS | DECDIGIT | DECRESULT )
-
PRECTYPE(ANS)
PREFIX(condition)
-
See page PREFIX
PROBE | NOPROBE
-
PROBE
PROCEED | NOPROCEED[(W | E | S)]
PRO | NPRO
NOPROCEED(S)
PROCESS[( KEEP | DELETE )] | NOPROCESS
-
PROCESS(DELETE)
QUOTE('"')
-
QUOTE('"')
REDUCE | NOREDUCE
-
REDUCE
RESEXP | NORESEXP
-
RESEXP
RESPECT([DATE])
-
RESPECT()
RULES(options)
-
See page RULES
SEMANTIC | NOSEMANTIC[(W | E | S)]
SEM | NSEM
NOSEMANTIC(S)
SNAP | NOSNAP
-
NOSNAP
SOSI | NOSOSI
-
NOSOSI
SOURCE | NOSOURCE
S | NS
NOSOURCE
STATIC(FULL | SHORT)
-
STATIC(SHORT)
STMT | NOSTMT
-
NOSTMT
STORAGE | NOSTORAGE
STG | NSTG
NOSTORAGE
SYNTAX | NOSYNTAX[(W | E | S)]
SYN | NSYN
NOSYNTAX(S)
SYSPARM('string')
-
SYSPARM('')
SYSTEM(  WINDOWS | CICS |   IMS  | PENTIUM  |  S486  )
-
SYSTEM( WINDOWS )
TERMINAL | NOTERMINAL
TERM | NTERM
TERMINAL
TEST(ALL | NONE | STMT,SYM | ,NOSYM) | NOTEST
-
NOTEST(ALL,SYM)3
USAGE(options)
-
See page USAGE
WIDECHAR(BIGENDIAN | LITTLEENDIAN)
WCHAR
WIDECHAR(BIGENDIAN)
WINDOW(w)
-
WINDOW(1950)
XINFO(options)
-
XINFO(NODEF,NOMSG,
NOSYMNOSYN,NOXMI,
NOXML)
XML( CASE( UPPER | ASIS ) )
-
XML( CASE(UPPER) )
XREF[(FULL | SHORT)] | NOXREF
X | NX
NX [(FULL)]1
Notes:
  1. FULL is the default suboption if the suboption is omitted with ATTRIBUTES or XREF.
  2. The default value for the BLANK character is the tab character with value '05'x.
  3. (ALL,SYM) is the default suboption if the suboption is omitted with TEST.

Terms of use | Feedback

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