Compile-time option descriptions

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).

There are three types of compiler options:

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)
Keywords that allow you to provide a value list that qualifies the option (for example, FLAG(W))
A combination of 1 and 2 above (for example, NOCOMPILE(E))

Table 1 lists all the compiler options with abbreviations (if any) and IBM-supplied default values. If an option has any suboptions that can 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 topics that follow.

Table 1. 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(10)
ASSERT(ENTRY \| CONDITION)	-	ASSERT(ENTRY)
ATTRIBUTES[(FULL\|SHORT)] \| NOATTRIBUTES	A \| NA	NA [(FULL)]¹
BACKREG(5 \| 11)	-	BACKREG(5)
BIFPREC(15 \| 31)	-	BIFPREC(31)
BLANK('c')	-	BLANK('t')²
BLKOFF \| NOBLKOFF	-	BLKOFF
BRACKETS('`symbol_1symbol_2`')	-	BRACKETS(‘[]’)
CASE(UPPER \| ASIS)	-	CASE(UPPER)
CASERULES(KEYWORD(LOWER \| MIXED \| START \| UPPER))	-	CASERULES(KEYWORD (MIXED))
CHECK(STORAGE \| NOSTORAGE)	-	CHECK(NSTG)
CMPAT(LE \| V1 \| V2 \| V3)	CMP	CMPAT(V2)
CODEPAGE(n)	CP	CODEPAGE(1140)
COMMON \| NOCOMMON	-	NOCOMMON
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
DBRMLIB('data-set-name') \| NODBRMLIB	-	NODBRMLIB
DD(ddname-list)	-	DD(SYSPRINT,SYSIN, SYSLIB,SYSPUNCH, SYSLIN,SYSADATA, SYSXMLSD,SYSDEBUG)
DDSQL(ddname)	-	DDSQL('')
DECIMAL(CHECKFLOAT \| NOCHECKFLOAT, FOFLONADD \| NOFOFLONADD, FOFLONASGN \| NOFOFLONASGN, FOFLONDIV \| NOFOFLONDIV, FOFLONMULT \| NOFOFLONMULT, FORCEDSIGN \| NOFORCEDSIGN, KEEPMINUS \| NOKEEPMINUS, TRUNCFLOAT \| NOTRUNCFLOAT )	DEC	DEC(NOCHECKFLOAT, NOFOFLONADD, FOFLONASGN, NOFOFLONDIV, NOFOFLONMULT, NOFORCEDSIGN, NOKEEPMINUS, NOTRUNCFLOAT)
DECOMP \| NODECOMP	-	NODECOMP
DEFAULT(attribute \| option)	DFT	See DEFAULT
DEPRECATE(BUILTIN(built-in-name) \| ENTRY(entry-name) \| INCLUDE(filename) \| STMT(statement-name) \| VARIABLE(variable-name))	-	DEPRECATE(BUILTIN() ENTRY() INCLUDE() STMT() VARIABLE())
DEPRECATENEXT(BUILTIN(built-in-name) \| ENTRY(entry-name) \| INCLUDE(filename) \| STMT(statement-name) \| VARIABLE(variable-name))	-	DEPRECATENEXT( BUILTIN() ENTRY() INCLUDE() STMT() VARIABLE())
DISPLAY (STD \| WTO(ROUTCDE(x) DESC(y) REPLY(z)))	-	DISPLAY(WTO)
DLL \| NODLL		NODLL
DLLINIT \| NODLLINIT	-	NODLLINIT
EXIT \| NOEXIT	-	NOEXIT
EXTRN(FULL \| SHORT)	-	EXTRN(FULL)
EXPORTALL	-	EXPORTALL
FILEREF \| NOFILEREF	-	FILEREF
FLAG[(I \| W \| E \| S)]	F	FLAG(W)
FLOAT(DFP \| NODFP)	-	FLOAT(NODFP)
FLOATINMATH(ASIS \| LONG \| EXTENDED)	-	FLOATINMATH(ASIS)
GOFF \| NOGOFF	-	NOGOFF
GONUMBER(SEPARATE \| NOSEPARATE) \| NOGONUMBER	GN \| NGN	NOGONUMBER
GRAPHIC \| NOGRAPHIC	GR \| NGR	NOGRAPHIC
IGNORE(ASSERT \| DISPLAY \| PUT) \| NOIGNORE	-	NOIGNORE
HEADER(SOURCE \| FILE)	-	SOURCE
HGPR(NOPRESERVE \| PRESERVE)	-	NOPRESERVE
INCAFTER([PROCESS(filename)])	-	INCAFTER()
INCDIR('directory name') \| NOINCDIR	-	NOINCDIR
INCLUDE \| NOINCLUDE	-	INCLUDE
INCPDS('PDS name') \| NOINCPDS	-	NOINCPDS
INITAUTO([ SHORT \| FULL ]) \| NOINITAUTO	-	NOINITAUTO
INITBASED \| NOINITBASED	-	NOINITBASED
INITCTL \| NOINITCTL	-	NOINITCTL
INITSTATIC \| NOINITSTATIC	-	NOINITSTATIC
INSOURCE[(FULL\|SHORT)(ALL\|FIRST)] \| NOINSOURCE	IS \| NIS	NOINSOURCE
INTERRUPT \| NOINTERRUPT	INT \| NINT	NOINTERRUPT
JSON(CASE(UPPER \| ASIS \| LOWER), GET(HEEDCASE \| IGNORECASE),TRIMR \| NOTRIMR)	-	JSON(CASE(UPPER), GET(HEEDCASE), TRIMR)
LANGLVL(NOEXT \| OS)	-	LANGLVL(OS)
LIMITS(options)	-	See LIMITS
LINECOUNT(n)	LC	LINECOUNT(31415)
LINEDIR \| NOLINEDIR	-	NOLINEDIR
LIST \| NOLIST	-	NOLIST
LISTVIEW(SOURCE \| AFTERMACRO \| AFTERCICS \| AFTERSQL \| AFTERALL)	-	LISTVIEW(SOURCE)
LP(32 \| 64)	-	LP(32)
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)
MAXBRANCH(max)	-	MAXBRANCH(2000)
MAXINIT	-	MAXINIT(64K)
MAXGEN(n)	-	MAXGEN(100000)
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))
MAXRUNONIF(n)	-	MAXRUNONIF(10)
MAXSTMT(n)	-	MAXSTMT(4096)
MAXTEMP(n)	-	MAXTEMP(50000)
MDECK \| NOMDECK	MD \| NMD	NOMDECK
MSGSUMMARY[(XREF \| NOXREF)] \| NOMSGSUMMARY	-	NOMSGSUMMARY
NAME[('external-name')] \| NONAME	N	NONAME
NAMES('lower'[,upper])	-	NAMES('#@$','#@$')
NATLANG(ENU \| UEN)	-	NATLANG(ENU)
NEST \| NONEST	-	NONEST
NOT	-	NOT('¬')
NULLDATE \| NONULLDATE	-	NONULLDATE
OBJECT \| NOOBJECT	OBJ \| NOBJ	OBJECT
OFFSET \| NOOFFSET	OF \| NOF	NOOFFSET
OFFSETSIZE(n)³	-	OFFSETSIZE(4)
ONSNAP(STRINGRANGE, 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
PPLIST(KEEP \| ERASE)	-	PPLIST(KEEP)
PPMACRO(’string’) \| NOPPMACRO	-	NOPPMACRO
PPSQL(’string’) \| NOPPSQL	-	NOPPSQL
PPTRACE \| NOPPTRACE	-	NOPPTRACE
PREFIX(condition)	-	See PREFIX
PRECTYPE(ANS \| DECDIGIT \| 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()
RTCHECK(NULLPTR \| NONULLPTR \| NULL370)	-	RTCHECK(NONULLPTR)
RULES(options)	-	See RULES
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 TEST⁴
UNROLL(AUTO \| NO)		UNROLL(AUTO)
USAGE(options)	-	See USAGE
WIDECHAR(BIGENDIAN \| LITTLEENDIAN)	WCHAR	WIDECHAR(BIGENDIAN)
WINDOW(w)	-	WINDOW(1950)
WRITABLE \| NOWRITABLE[(FWS\|PRV)]	-	WRITABLE
XINFO(options)	-	XINFO(NODEF,NOMSG, NOSYM,NOSYN,NOXML)
XML(CASE( UPPER \| ASIS))	-	XML(CASE(UPPER))
XREF[(FULL \| SHORT)(EXPLICIT \| IMPLICIT)] \| NOXREF	X \| NX	NX [(FULL)]¹
Notes: FULL is the default suboption if the suboption is omitted with ATTRIBUTES or XREF. The default value for the BLANK character is the tab character with value '05'x. The OFFSETSIZE option is ignored if the LP(32) option is in effect. (ALL,SYM) is the default suboption if the suboption is omitted with TEST.

The following topics describe the options in alphabetical order. For those options specifying that the compiler is to list information, only a brief description is included. For details about the generated listing, see Using the compiler listing.