Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, 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 3 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 3 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 3. Compile-time options, abbreviations, and IBM-supplied defaults
Compile-Time Option
Abbreviated Name
z/OS Default
AGGREGATE[(DEC|HEX)] | NOAGGREGATE
AG | NAG
NOAGGREGATE
ARCH( n )
-
ARCH(5)
ATTRIBUTES[(FULL|SHORT)] |
  NOATTRIBUTES
A | NA
NA [(FULL)]1
BACKREG( 5 | 11 )
-
BACKREG(5)
BIFPREC( 15 | 31 )
-
BIFPREC(15)
BLANK('c')
-
BLANK('t')2
BLKOFF | NOBLKOFF
-
BLKOFF
CEESTART(FIRST | LAST)
-
CEESTART(FIRST)
CHECK(STORAGE | NOSTORAGE,
CONFORMANCE | NOCONFORMANCE)
-
CHECK(NSTG,
NOCONFORMANCE)
CMPAT(LE | V1 | V2 | V3)
-
CMPAT(V2)
CODEPAGE(n)
CP
CODEPAGE(1140)
COMMON | NOCOMMON
-
NOCOMMON
COMPACT | NOCOMPACT
-
NOCOMPACT
COMPILE | NOCOMPILE[(W | E | S)]
C | NC
NOCOMPILE(S)
COPYRIGHT(’string’ ) | NOCOPYRIGHT
-
NOCOPYRIGHT
CSECT | NOCSECT
CSE | NOCSE
CSECT
CSECTCUT( n )
-
CSECTCUT(4)
CURRENCY('c')
CURR
CURRENCY($)
DBCS | NODBCS
-
NODBCS
DD(ddname-list)
-
DD(SYSPRINT,SYSIN,
SYSLIB,SYSPUNCH,
SYSLIN,SYSADATA,
SYSXMLSD,SYSDEBUG)
DDSQL(ddname)
-
DDSQL('')
DECIMAL( FOFLONASGN | NOFOFLONASGN,
FOFLONMULT | NOFOFLONMULT,
FORCEDSIGN, NOFORCEDSIGN )
DEC
DEC(FOFLONASGN,
NOFOFLONMULT,
NOFORCEDSIGN)
DEFAULT(attribute | option)
DFT
See page ***
DISPLAY(STD | WTO( ROUTCDE(x) DESC(y) REPLY(z) )  )
-
DISPLAY(WTO)
DLLINIT | NODLLINIT
-
NODLLINIT
EXIT | NOEXIT
-
NOEXIT
EXTRN(FULL | SHORT)
-
EXTRN(FULL)
FLAG[(I | W | E | S)]
F
FLAG(W)
FLOAT( AFP( NOVOLATILE | VOLATILE )
| NOAFP, DFP | NODFP )
-
FLOAT( AFP(NOVOLATILE)
NODFP )
FLOATINMATH( ASIS | LONG | EXTENDED )
-
FLOATINMATH( ASIS )
GOFF | NOGOFF
-
NOGOFF
GONUMBER | NOGONUMBER
GN | NGN
NOGONUMBER
GRAPHIC | NOGRAPHIC
GR | NGR
NOGRAPHIC
HGPR[(PRESERVE|NOPRESERVE)] | NOHGPR
-
NOHGPR
INCAFTER([PROCESS(filename)])
-
INCAFTER()
INCDIR('directory name') | NOINCDIR
-
NOINCDIR
INCPDS('PDS name') | NOINCPDS
-
NOINCPDS
INITAUTO | NOINITAUTO
-
NOINITAUTO
INITBASED | NOINITBASED
-
NOINITBASED
INITCTL | NOINITCTL
-
NOINITCTL
INITSTATIC | NOINITSTATIC
-
NOINITSTATIC
INSOURCE[(FULL|SHORT)] | NOINSOURCE
IS | NIS
NOINSOURCE
INTERRUPT | NOINTERRUPT
INT | NINT
NOINTERRUPT
LANGLVL(SAA | SAA2[,NOEXT | OS])
-
LANGLVL(SAA2,OS)
LIMITS(options)
-
See  
LINECOUNT(n)
LC
LINECOUNT(60)
LINEDIR | NOLINEDIR
-
NOLINEDIR
LIST | NOLIST
-
NOLIST
LISTVIEW( SOURCE | AFTERMACRO
| AFTERCICS | AFTERSQL | AFTERALL )
-
LISTVIEW(SOURCE)
MACRO | NOMACRO
M | NM
NOMACRO
MAP | NOMAP
-
NOMAP
MARGINI('c') | NOMARGINI
MI | NMI
NOMARGINI
MARGINS(m,n[,c])| NOMARGINS
MAR(m,n)
MARGINS
F-format: (2,72)
V-format: (10,100)
MAXMEM(n)
MAXM
MAXMEM(1048576)
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(50000)
MDECK | NOMDECK
MD | NMD
NOMDECK
NAME[('external name')] | NONAME
N
NONAME
NAMES('lower'[,upper])
-
NAMES('#@$','#@$')
NATLANG(ENU | UEN)
-
NATLANG(ENU)
NEST | NONEST
-
NONEST
NOT
-
NOT('¬')
NUMBER | NONUMBER
NUM | NNUM
NUMBER
OBJECT | NOOBJECT
OBJ | NOBJ
OBJECT
OFFSET | NOOFFSET
OF | NOF
NOOFFSET
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
PREFIX(condition)
-
See page ***
PRECTYPE( ANS | DECRESULT )
-
PRECTYPE(ANS)
PROCEED | NOPROCEED[(W | E | S)]
PRO | NPRO
NOPROCEED(S)
PROCESS[( KEEP | DELETE )] | NOPROCESS
-
PROCESS(DELETE)
QUOTE('"')
-
QUOTE('"')
REDUCE | NOREDUCE
-
REDUCE
RENT | NORENT
-
NORENT
RESEXP | NORESEXP
-
RESEXP
RESPECT([DATE])
-
RESPECT()
RULES(options)
-
See  
SEMANTIC | NOSEMANTIC[(W | E | S)]
SEM | NSEM
NOSEMANTIC(S)
SERVICE('service string') | NOSERVICE
SERV | NOSERV
NOSERVICE
SOURCE | NOSOURCE
S | NS
NOSOURCE
SPILL(n)
SP
SPILL(512)
STATIC(FULL | SHORT)
-
STATIC(SHORT)
STDSYS | NOSTDSYS
-
NOSTDSYS
STMT | NOSTMT
-
NOSTMT
STORAGE | NOSTORAGE
STG | NSTG
NOSTORAGE
STRINGOFGRAPHIC(CHAR | GRAPHIC)
-
STRINGOFGRAPHIC
(GRAPHIC)
SYNTAX | NOSYNTAX[(W | E | S)]
SYN | NSYN
NOSYNTAX(S)
SYSPARM('string')
-
SYSPARM('')
SYSTEM(MVS | CICS | IMS | TSO | OS)
-
SYSTEM(MVS)
TERMINAL | NOTERMINAL
TERM | NTERM

TEST(options) | NOTEST
-
See  TEST3
TUNE( n )
-
TUNE(5)
USAGE(options)
-
See  USAGE
WIDECHAR(BIGENDIAN | LITTLEENDIAN)
WCHAR
WIDECHAR(BIGENDIAN)
WINDOW(w)
-
WINDOW(1950)
WRITABLE | NOWRITABLE[(FWS|PRV)]
-
WRITABLE
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)