Compiler cobc options
The following list of options was extracted from cobc --help and shows all available compiler options with a short description.
Common Options
-h, --help-
display this help and exit
-V, --version-
display compiler version information and exit
-dumpversion-
display compiler version and exit
-i, --info-
display compiler information (build/environment) and exit
-v, --verbose-
verbose mode, display additional information; multiple
-voptions increase the verbosity, the maximum is 3 as follows: (1) display compiler version and the commands invoked by the compiler, (2) pass verbose option to assembler/compiler (3) pass verbose option to linker -q, --brief-
reduced displays, commands invoked not shown
-###-
like -v but commands not executed
-x-
build an executable program
-m-
build a dynamically loadable module (default)
-j [args], --job[=args]-
run program after build, passing <args>
-std=dialect-
warnings/features for a specific dialect <dialect> can be one of: default, cobol2014, cobol2002, cobol85, xopen, ibm-strict, ibm, mvs-strict, mvs, mf-strict, mf, bs2000-strict, bs2000, acu-strict, acu, rm-strict, rm, gcos-strict, gcos; see configuration files in directory config
-F, --free-
use free source format (alias for -fformat=free)
--fixed-
use fixed source format (default; alias for
-fformat=fixed)-O, -O2, -O3, -Os-
enable optimization
-O0-
disable optimization
-g-
enable C compiler debug and stack check
-d, --debug-
enable all run-time error checking, equal to
-fstack-check-fec=``EC-ALL -fec=exception-name-
enable code generation for <exception-name>, see –list-exceptions for the possible values, sets
-fsource-location -fno-ec=exception-name-
disable code generation for <exception-name>
-o file-
place the output into <file>
-b-
combine all input files into a single dynamically loadable module
-E-
preprocess only; do not compile or link
-C-
translation only; convert COBOL to C
-S-
compile only; output assembly file
-c-
compile and assemble, but do not link
-T file-
generate and place a wide program listing into <file>
-t file-
generate and place a program listing into <file>
--tlines=lines-
specify lines per page in listing, default = 55
-P[=dir or file]-
generate preprocessed program listing (.lst)
-X, --Xref-
specify cross reference in listing
-I directory-
add <directory> to copy/include search path
--copy copybook-
include <copybook> at beginning of file, as would
COPYcopybook. -L directory-
add <directory> to library search path
--include file.h-
add a #include "file.h" at the beginning of the C generated file (implies
-fno-gen-c-decl-static-call) -l lib-
link the library <lib>
-K entry-
generate
CALLto <entry> as static -D define-
define <define> for COBOL compilation
-A options-
add <options> to the C compile phase
-Q options-
add <options> to the C link phase
--coverage-
instrument generated binaries for coverage
--conf=file-
user-defined dialect configuration; see -std
--list-reserved-
display reserved words
--list-intrinsics-
display intrinsic functions
--list-mnemonics-
display mnemonic names
--list-exceptions-
display exception names
--list-system-
display system routines
--save-temps[=dir]-
save intermediate files; default: current directory
-M-
output dependency list in Makefile format
-MT target-
set/add target file used in dependency list
-MQ target-
same as -
MTbut with Makefile-quoting of the target -MF file-
place dependency list into <file>
-MP-
create phony targets for all dependencies
-MG-
output missing dependencies without complaining
-MD-
output dependencies in .d files while compiling
-ext extension-
add file extension for resolving
COPY --gentable=ebcdic-enc,ascii-enc[+]-
output a translation table between the given encodings to stdout and exit
Warning options
-Wall-
enable most warnings (all except as noted below)
-Wextra-
like -Wall but enable some extra warning flags
-w-
disable all warnings
-Wno-warning-
disable warning enabled by default, -Wall or -Wextra
-Wadditional-
additional warnings only raised with -Wall
-Wno-unfinished-
do not warn if unfinished features are used; always active
-Wno-pending-
do not warn if pending features are used; always active
-Wno-repository-checks-
do not warn/check for program/function/external signature mismatch; always active
-Wno-ignored-error-
do not warn about errors in code parts which are unreachable and so normally ignored; always active
-Wobsolete-
warn if obsolete features are used
-Warchaic-
warn if archaic features are used
-Wredefinition-
warn about non-referenced ambiguous data items
-Wtruncate-
warn about field truncation from constant assignments
-Wpossible-truncate-
warn about possible field truncation; not set with
-Wall -Woverlap-
warn about overlapping
MOVEof items -Wpossible-overlap-
warn about
MOVEof items that may overlap depending on variables; not set with-Wall -Wparentheses-
warn if parentheses are omitted around
ANDwithinOR -Wstrict-typing-
warn strictly about type mismatch, even when same size; not set with
-Wall -Wtyping-
warn about type mismatch
-Wimplicit-define-
warn about implicitly defined data items; not set with
-Wall -Wno-corresponding-
do not warn about
CORRESPONDINGwith no matching items; always active -Winitial-value-
warn if initial
VALUEclause is ignored -Wprototypes-
warn about missing
FUNCTIONprototypes/definitions -Warithmetic-osvs-
warn if arithmetic expression precision has changed
-Wcall-params-
warn about non 01/77 items for
CALLparameters; not set with-Wall -Wconstant-expression-
warn about expressions that always resolve to true/false
-Wconstant-numlit-expression-
warn about numeric expressions that always resolve to true/false
-Wlarger-01-redefines-
warn about larger redefines allowed by COBOL standards
-Wcolumn-overflow-
warn about text after program-text area,
FIXEDformat; not set with-Wall -Wterminator-
warn about lack of scope terminator
END-XXX; not set with-Wall -Wlinkage-
warn about dangling
LINKAGEitems; not set with-Wall -Wunreachable-
warn about likely unreachable statements; not set with
-Wall -Wno-dialect-
do not warn about dialect specific issues; always active
-Wno-goto-section-
do not warn about
GOTOsection-name; always active -Wgoto-different-section-
warn about
GOTOa praragraph defined in a different section -Wsuspicious-perform-thru-
warn if
PERFORMTHRUreferences procedures not in ascending order or multiple sections; always active -Wdangling-text-
warn about source text after program-area; not set with
-Wall -Wno-missing-newline-
do not warn about missing newlines; always active
-Wno-others-
do not warn about different issues; always active
-Wno-unsupported-
do not warn if runtime does not support a feature used
-fdiagnostics-plain-output-
make diagnostic output as plain as possible
-Werror-
treat all warnings as errors
-Wno-error-
don’t treat warnings as errors
-Werror=warning-
treat specified <warning> as error
-Wno-error=warning-
don’t treat specified <warning> as error
Compiler options
-fsign=[ASCII|EBCDIC]-
define display sign representation; default: machine native
-ffold-copy=[UPPER|LOWER]-
fold
COPYsubject to value; default: no transformation -ffold-call=[UPPER|LOWER]-
fold
PROGRAM-ID,CALL,CANCELsubject to value; default: no transformation -fmax-errors=number-
maximum number of errors to report before compilation is aborted; default: 20; if <number> is 0, there’s no limit
-fintrinsics=[ALL|intrinsic function name(,name,...)]-
intrinsics to be used without
FUNCTIONkeyword -fdump=scope-
dump data fields on abort, <scope> may be a combination of:
ALL,WS,LS,RD,FD,SC,LOdefault if no scope specified:ALL -fcallfh=name-
specifies <name> to be used for I/O as external provided EXTFH interface module
-fsqlschema=name-
define database schema name
-febcdic-table=cconv-table/file-
EBCDIC/ASCIItranslation table; e.g. default, ebcdic500_latin1... -fdefault-colseq=[ASCII|EBCDIC|NATIVE]-
define default collating sequence; default:
NATIVE -fdefault-file-colseq=[ASCII|EBCDIC|NATIVE]-
define default file collating sequence; default:
NATIVE -fsql-
process the
XFDdirectives -fuse-constructor-
generate internal one-time code via constructor
-fstack-extended-
store origin of entrypoints and
PERFORM; turned on by --debug/-fdump -fno-remove-unreachable-
disable remove of unreachable code; turned off by
-g -finline-intrinsic-
when possible resolve intrinsic
FUNCTIONs at compile time -ftrace-
generate trace code; scope: executed
SECTION/PARAGRAPH -ftraceall-
generate trace code; scope: executed
SECTION/PARAGRAPH/STATEMENTS -fsymtab-
build symbol table for dump/trace/debug
-fsyntax-only-
syntax error checking only; don’t emit any output
-fdebugging-line-
enable debugging lines; ‘
D’ in indicator column or floating>>D -fsource-location-
generate source location code; turned on by -
-debug/-ftraceall/-fec/-fdump -fimplicit-init-
automatic initialization of the COBOL runtime system
-fno-recursive-check-
disable check of recursive program call; effectively compiling as
RECURSIVEprogram -fstack-check-
PERFORMstack checking; turned on by --debug/-g -fmemory-check=scope-
checks for invalid writes to internal storage, <scope> may be one of: all, pointer, using, none; default: none, set to all by -
-debug -fsection-exit-check-
check that code execution does not leave the scope of
SECTIONs -fimplicit-goback-check-
check that code execution does not end implicit at end of
PROCEDUREDIVISION -fwrite-after-
use
AFTER 1forWRITEofLINESEQUENTIAL; default:BEFORE 1 -fmfcomment-
‘
*’ in column 1 treated as comment with listing suppression; FIXED/COBOL85/VARIABLE format only -facucomment-
‘
$’ in indicator area treated as ‘*’, ‘|’ treated as floating comment -fno-trunc-
allow numeric field overflow; non-ANSI behaviour
-fsingle-quote-
use a single quote (apostrophe) for
QUOTE; default: double quote -foptional-file-
treat all files as
OPTIONAL; unlessNOTOPTIONALspecified -fstatic-call-
output static function calls for the
CALLstatement -fno-gen-c-decl-static-call-
disable generation of C function declarations for subroutines with static
CALL -fgen-c-line-directives-
generate source location directives in C code;; turned on by
-g/–coverage -fgen-c-labels-
generate extra labels in C sources;; turned on by
-g -fmf-files-
Sequential & Relative files will match Micro Focus format
-ffile-format=[MF|GC]-
define default format for
Sequential/Relative files; default:GC -fno-theaders-
suppress all headers from listing while keeping page breaks
-fno-tsource-
suppress source from listing
-fno-tmessages-
suppress warning and error summary from listing
-ftsymbols-
specify symbols in listing
-ftcmd-
specify command line in listing
-fdatamap-
specify symbols
DATAMAPin listing -fno-ttimestamp-
suppress timestamp in listing headers
-fttitle=title-
set listing title with ‘
_’ replaced by spaces; defaults to package name and version -fno-diagnostics-show-option-
suppress output of option that directly controls the diagnostic
-fno-diagnostics-show-caret-
do not display source context on warning/error diagnostic
-fno-diagnostics-show-line-numbers-
suppress display of line numbers in diagnostics
-fdiagnostics-absolute-paths-
print absolute paths in diagnostics
-fprof-
enable profiling of the COBOL program
-fibmcomp-
sets -fbinary-size=2-4-8 -fsynchronized-clause=ok
-fno-ibmcomp-
sets -fbinary-size=1–8 -fsynchronized-clause=ignore
Compiler dialect configuration options
-freserved-words=value-
use of complete/fixed reserved words
-ftab-width=value-
number of spaces that are assumed for tabs (comma separated)
-ftext-column=72..255-
right margin column number for fixed-form reference-format
-fpic-length=number-
maximum number of characters allowed in the
PICTUREcharacter-string -fword-length=1..63-
maximum word-length for COBOL (= programmer defined) words
-fliteral-length=number-
maximum literal size in general
-fnumeric-literal-length=1..38-
maximum numeric literal size
-falign-record=0..256-
align
WORKING-STORAGE/LOCAL-STORAGErecord on boundary -fkeycompress=0..16-
do
ISAMindexes with duplicates get compressed -falign-opt-
align like
MFOPT, Default: false (LikeMFALIGN=FIXED) -fdefaultbyte=value-
default initialization for fields without
VALUE, may be one of; character in quotes; decimal 0..255 representing a character; "init" to initialize toPICTURE/USAGE; "none" to do no explicit initialization; default: "init" -fformat=value-
default reference-format, may be one of:
FIXED,FREE, COBOL85,VARIABLE,XOPEN,XCARD,CRT,TERMINAL, COBOLX -fbinary-size=value-
binary byte size - defines the allocated bytes according to
PIC, may be one of: 2-4-8, 1-2-4-8, 1–8 -fbinary-byteorder=value-
binary byte order, may be one of: native, big-endian
-fassign-clause=value-
how to interpret
ASSIGN word: asASSIGN EXTERNAL wordorASSIGN DYNAMIC word, may be one of:dynamic,external,ibm(= external),mf(= dynamic) -fscreen-section-rules=value-
which compiler’s rules to apply to
SCREENSECTIONitem clauses, may be one of: acu, gc, mf, rm, std, xopen -fdpc-in-data=value-
whether
DECIMAL-POINTISCOMMAhas effect inXML/JSONGENERATE, may be one of: none, xml, json, all -fsubscript-check=value-
checking for subscript (only done with
EC-BOUND-SUBSCRIPTactive), may be one of: full, max, record -ffilename-mapping-
resolve file names at run time using environment variables
-fpretty-display-
alternate formatting of numeric fields
-fbinary-truncate-
numeric truncation according to ANSI
-fcomplex-odo-
allow non-standard
OCCURSDEPENDINGONsyntax -fodoslide-
adjust items following
OCCURSDEPENDING(implies complex-odo) -finit-justify-
applies
JUSTIFYwithVALUEclause -findirect-redefines-
allow
REDEFINESto other than last equal level number -frelax-syntax-checks-
allow certain syntax variations (e.g.
REDEFINESposition) -fref-mod-zero-length-
allow zero length reference-modification (only changed with
EC-BOUND-REF-MODactive) -frelax-level-hierarchy-
allow non-matching level numbers
-flocal-implies-recursive-
LOCAL-STORAGESECTIONimpliesRECURSIVEattribute -fsticky-linkage-
LINKAGESECTIONitems remain allocated between invocations -fmove-ibm-
MOVEoperates as on IBM (left to right, byte by byte), otherwise no propagating move -fperform-osvs-
exit point of any currently executing perform is recognized if reached
-farithmetic-osvs-
limit precision in intermediate results to precision of final result (less accurate)
-fconstant-folding-
evaluate constant expressions at compile time
-fhostsign-
allow hexadecimal value ‘
F’ forNUMERICtest of signedPACKEDDECIMALfield -fprogram-name-redefinition-
program names don’t lead to a reserved identifier
-faccept-update-
set
WITHUPDATEclause as default forACCEPTdest-item, instead ofWITHNOUPDATE -faccept-auto-
set
WITHAUTOclause as default forACCEPTdest-item, instead ofWITHTAB -fconsole-is-crt-
assume
CONSOLEISCRTif not set otherwise -fno-echo-means-secure-
NO-ECHOhides input with asterisks likeSECURE -fline-col-zero-default-
assume a field
DISPLAYstarts atLINE 0COL 0(i.e. at the cursor), notLINE 1COL 1 -freport-column-plus-
in a
REPORTCOLUMNmay havePLUSnum, + num, or +num -fdisplay-special-fig-consts-
special behaviour of
DISPLAYSPACE/ALLX'01'/ALLX'02'/ALLX'07' -fbinary-comp-1-
COMP-1 is a 16-bit signed integer -fnumeric-pointer-
POINTERis a 64-bit unsigned integer -fmove-non-numeric-lit-to-numeric-is-zero-
imply zero in move of non-numeric literal to numeric items
-fimplicit-assign-dynamic-var-
implicitly define a variable if an
ASSIGNDYNAMICdoes not match any data item -fdevice-mnemonics-
specifying device by mnemonic
-fxml-parse-xmlss-
XMLPARSEXMLSS -fareacheck-
check contents of Area A (when reference format supports Area A enforcement), enabled checks include:; division, section, paragraph names, level indicators (
FD,SD,RD, andCD), and toplevel numbers (01 and 77) must start in Area A;; statements must not start in Area A; and; separator periods must not be within Area A -fcomment-paragraphs=support-
comment paragraphs in
IDENTIFICATIONDIVISION(AUTHOR,DATE-WRITTEN, ...) -fcontrol-division=support-
CONTROLDIVISION -fpartial-replace-when-literal-src=support-
apply partial replacing with literal source operand even when it replaces with spaces only;; "skip" prevents such replacements
-fmemory-size-clause=support-
MEMORY-SIZEclause -fmultiple-file-tape-clause=support-
MULTIPLE-FILE-TAPEclause -flabel-records-clause=support-
LABEL-RECORDSclause -fvalue-of-clause=support-
VALUE-OFclause -fdata-records-clause=support-
DATA-RECORDSclause -ftop-level-occurs-clause=support-
OCCURSclause on top-level -fsame-as-clause=support-
SAMEASclause -ftype-to-clause=support-
TYPETOclause -fusage-type=support-
USAGEtype-name -fsynchronized-clause=support-
SYNCHRONIZEDclause -fsync-left-right=support-
LEFT/RIGHTphrases inSYNCHRONIZEDclause -fspecial-names-clause=support-
SPECIAL-NAMESclause -fgoto-statement-without-name=support-
GOTOstatement without name -fstop-literal-statement=support-
STOP-literal statement -fstop-identifier-statement=support-
STOP-identifier statement -fstop-error-statement=support-
STOPERRORstatement -fdebugging-mode=support-
DEBUGGINGMODEand debugging indicator -fuse-for-debugging=support-
USEFORDEBUGGING -fpadding-character-clause=support-
PADDINGCHARACTERclause -fnext-sentence-phrase=support-
NEXTSENTENCEphrase -flisting-statements=support-
listing-directive statements
EJECT,SKIP1,SKIP2,SKIP3 -ftitle-statement=support-
listing-directive statement
TITLE -fentry-statement=support-
ENTRYstatement -fmove-noninteger-to-alphanumeric=support-
move noninteger to alphanumeric
-foccurs-max-length-without-subscript-
occurs max length without subscript
-flength-in-data-division-
length in data division
-fmove-figurative-constant-to-numeric=support-
move figurative constants to numeric
-fmove-figurative-space-to-numeric=support-
move figurative constant
SPACEto numeric -fmove-figurative-quote-to-numeric=support-
move figurative constant
QUOTEto numeric -fodo-without-to=support-
OCCURSDEPENDINGONwithout to -fodo-last-varlen=support-
OCCURSDEPENDINGONlast of record then variable lenght -fsection-segments=support-
section segments
-falter-statement=support-
ALTERstatement -fcall-overflow=support-
OVERFLOWclause forCALL -fnumeric-boolean=support-
boolean literals (
B'1010') -fhexadecimal-boolean=support-
hexadecimal-boolean literals (
BX‘A’) -fnational-literals=support-
national literals (
N'UTF-16 string’) -fhexadecimal-national-literals=support-
hexadecimal-national literals (
NX'265E') -fnational-character-literals=support-
non-standard national literals (
NC'UTF-16 string’) -fhp-octal-literals=support-
HPCOBOL octal literals (%377) -facu-literals=support-
ACUCOBOL-GT literals (
#B#O#H#X) -febcdic-symbolic-characters-
EBCDICsymbolic characters in literals (" "135,151,151"bar"195, 194"Z" for " foobarBAZ") -fword-continuation=support-
continuation of COBOL words
-fnot-exception-before-exception=support-
NOTONEXCEPTIONbeforeONEXCEPTION -faccept-display-extensions=support-
extensions to
ACCEPTandDISPLAY -frenames-uncommon-levels=support-
RENAMESof 01-, 66- and 77-level items -flarger-redefines=support-
allow larger
REDEFINESitems -fsymbolic-constant=support-
constants defined in
SPECIAL-NAMES -fconstant-78=support-
constant with level 78 item (note: has left to right precedence in expressions)
-fconstant-01=support-
constant with level 01
CONSTANTAS/FROMitem -fperform-varying-without-by=support-
PERFORMVARYINGwithoutBYphrase (impliesBY 1) -freference-out-of-declaratives=support-
references to sections not in
DECLARATIVESfrom withinDECLARATIVES -freference-bounds-check=support-
reference modification strict bounds check
-fprogram-prototypes=support-
CALL/CANCELwith program-prototype-name -fcall-convention-mnemonic=support-
specifying call-convention by mnemonic
-fcall-convention-linkage=support-
specifying call-convention by
WITH...LINKAGE -fnumeric-value-for-edited-item=support-
numeric literals in
VALUEclause of numeric-edited items -fincorrect-conf-sec-order=support-
incorrect order of
CONFIGURATIONSECTIONand its paragraphs -fdefine-constant-directive=support-
allow >>
DEFINECONSTANTvarASliteral -ffree-redefines-position=support-
REDEFINESclause not following entry-name in definition -frecords-mismatch-record-clause=support-
record sizes does not match
RECORDclause -frecord-delimiter=support-
RECORDDELIMITERclause -fsequential-delimiters=support-
BINARY-SEQUENTIALandLINE-SEQUENTIALphrases inRECORDDELIMITER -frecord-delim-with-fixed-recs=support-
RECORDDELIMITERclause on file with fixed-length records -frecord-sequential-advancing=support-
SEQUENTIALwithWRITEADVANCINGphrases -fmissing-statement=support-
missing statement (e.g. empty
IF/PERFORM) -fmissing-period=support-
missing period in
PROCEDUREDIVISION(when reference format supports Area A enforcement) -fzero-length-literals=support-
zero-length literals, e.g. ” and ""
-fxml-generate-extra-phrases=support-
XMLGENERATE's phrases other thanCOUNTIN -fcontinue-after=support-
AFTERphrase inCONTINUEstatement -fgoto-entry=support-
ENTRYFORGOTOandGOTOENTRYstatements -fdepending-on-not-fixed=support-
depending-on-not-fixed
-fbinary-sync-clause=support-
BINARY-SHORT/LONG/DOUBLESYNCHRONIZEDclause -fnonnumeric-with-numeric-group-usage=support-
Non-numeric item with numeric group
USAGEclause -fassign-variable=support-
ASSIGN[TO]variable inSELECT -fassign-using-variable=support-
ASSIGNUSING/VARYINGvariable inSELECT -fassign-ext-dyn=support-
ASSIGNEXTERNAL/DYNAMICinSELECT -fassign-disk-from=support-
ASSIGNDISKFROMvariable inSELECT -fvsam-status=support-
VSAMstatus inFILESTATUS -fself-call-recursive=support-
CALLto ownPROGRAM-IDimpliesRECURSIVEattribute -frecord-contains-depending-clause=support-
DEPENDINGclause inRECORDCONTAINS -fpicture-l=support-
PICTUREstring with ‘L’ character where <support> is one of:ok,warning,archaic,obsolete,skip,ignore,error,unconformable -fnot-reserved=word-
<word> to be taken out of the reserved words list
-freserved=word-
<word> to be added to reserved words list
-freserved=word:alias-
<word> to be added to reserved words list as <alias>
-fnot-register=word-
special register to disable
-fregister=word or word:definition, where definition uses backslash esca-
special register to enable