GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
COBC(1) User Commands COBC(1)

cobc - manual page for cobc (GnuCOBOL) 3.1.2.0

cobc [options]... file...

GnuCOBOL compiler for most COBOL dialects with lots of extensions

-h, -help
display this help and exit
-V, -version
display compiler version and exit
-i, -info
display compiler information (build/environment) and exit
-v, -verbose
verbose mode, display additional information; multiple -v options 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; see configuration files in directory config
-F, -free
use free source format
-fixed
use fixed source format (default)
-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>,
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)
-Xref
generate cross reference through 'cobxref' (V. Coen's 'cobxref' must be in path)
-I <directory>
add <directory> to copy/include search path
-L <directory>
add <directory> to library search path
-l <lib>
link the library <lib>
-A <options>
add <options> to the C compile phase
-Q <options>
add <options> to the C link phase
-D <define>
define <define> for COBOL compilation
-K <entry>
generate CALL to <entry> as static
-conf=<file>
user-defined dialect configuration; see -std
-list-reserved
display reserved words
-list-intrinsics
display intrinsic functions
-list-mnemonics
display mnemonic names
-list-system
display system routines
-save-temps[=<dir>]
save intermediate files * default: current directory
-ext <extension>
add file extension for resolving COPY

-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 mentioned * ALWAYS active
-Wno-ignored-error
do not warn about errors in unreachable code parts 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 MOVE of items
-Wpossible-overlap
warn about MOVE of items that may overlap depending on variables * NOT set with -Wall
-Wparentheses
warn about lack of parentheses around AND within OR
-Wstrict-typing
warn strictly about type mismatch
-Wimplicit-define
warn about implicitly defined data items * NOT set with -Wall
-Wno-corresponding
do not warn about CORRESPONDING with no matching items * ALWAYS active
-Winitial-value
warn if initial VALUE clause is ignored
-Wprototypes
warn about missing FUNCTION prototypes/definitions
-Warithmetic-osvs
warn if arithmetic expression precision has changed
-Wcall-params
warn about non 01/77 items for CALL parameters * NOT set with -Wall
-Wconstant-expression
warn about expressions that always resolve to true/false
-Wcolumn-overflow
warn about text after program-text area, FIXED format * NOT set with -Wall
-Wterminator
warn about lack of scope terminator END-XXX * NOT set with -Wall
-Wlinkage
warn about dangling LINKAGE items * 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
-Wdangling-text
warn source text after program-area * NOT set with -Wall
-Wno-others
do not warn about different issues * ALWAYS active
-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

-fsign=[ASCII|EBCDIC] define display sign representation
* default: machine native
-ffold-copy=[UPPER|LOWER]
fold COPY subject to value * default: no transformation
-ffold-call=[UPPER|LOWER]
fold PROGRAM-ID, CALL, CANCEL subject to value * default: no transformation
-fdefaultbyte=<value> initialize fields without VALUE to value
* decimal 0..255 or any quoted character * default: initialize to picture
-fmax-errors=<number> maximum number of errors to report before
compilation is aborted * default: 128
-fintrinsics=[ALL|intrinsic function name(,name,...)]
intrinsics to be used without FUNCTION keyword
-fdump=<scope>
dump data fields on abort, <scope> may be a combination of: ALL, WS, LS, RD, FD, SC, LO
-fcallfh=<name>
specifies <name> to be used for I/O as external provided EXTFH interface module
-fno-remove-unreachable
disable remove of unreachable code * turned off by -g
-ftrace
generate trace code * scope: executed SECTION/PARAGRAPH
-ftraceall
generate trace code * scope: executed SECTION/PARAGRAPH/STATEMENTS
-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/-g/-ftraceall/-fec
-fimplicit-init
automatic initialization of the COBOL runtime system
-fno-recursive-check
disable check of recursive program call; effectively compiling as RECURSIVE program
-fstack-check
PERFORM stack checking * turned on by -debug or -g
-fwrite-after
use AFTER 1 for WRITE of LINE SEQUENTIAL * default: BEFORE 1
-fmfcomment
'*' or '/' in column 1 treated as comment * FIXED format only
-facucomment
'$' in indicator area treated as '*', '|' treated as floating comment
-fnotrunc
allow numeric field overflow * non-ANSI behaviour
-fodoslide
adjust items following OCCURS DEPENDING * implies -fcomplex-odo
-fsingle-quote
use a single quote (apostrophe) for QUOTE * default: double quote
-foptional-file
treat all files as OPTIONAL * unless NOT OPTIONAL specified
-fstatic-call
output static function calls for the CALL statement
-fno-gen-c-decl-static-call
disable generation of C function declations for subroutines with static CALL
-fgen-c-line-directives
generate source location directives in C code; * turned on by -g
-fgen-c-labels
generate extra labels in C sources; * turned on by -g
-fno-theaders
suppress all headers and output of compilation options 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
-fno-diagnostics-show-option
suppress output of option that directly controls the diagnostic

-freserved-words=<value>
use of complete/fixed reserved words
-ftab-width=1..12
set number of spaces that are assumed for tabs
-ftext-column=72..255
set right margin for source (fixed format only)
-fpic-length=<number>
maximum number of characters allowed in the PICTURE character-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
-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': as 'ASSIGN EXTERNAL word' or 'ASSIGN DYNAMIC word', may be one of: dynamic, external, ibm (= external), mf (= dynamic)
-fscreen-section-rules=<value>
which compiler's rules to apply to SCREEN SECTION item clauses, may be one of: acu, gc, mf, rm, std, xopen
-fdpc-in-data=<value>
whether DECIMAL-POINT IS COMMA has effect in XML/JSON GENERATE, may be one of: none, xml, json, all
-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 complex OCCURS DEPENDING ON
-findirect-redefines
allow REDEFINES to other than last equal level number
-flarger-redefines-ok
allow larger REDEFINES items
-frelax-syntax-checks
allow certain syntax variations (e.g. REDEFINES position)
-fref-mod-zero-length
allow zero length reference-modification (only changed with EC-BOUND-REF-MOD active)
-frelax-level-hierarchy
allow non-matching level numbers
-fselect-working
require ASSIGN USING items to be in WORKING-STORAGE
-flocal-implies-recursive
LOCAL-STORAGE SECTION implies RECURSIVE attribute
-fsticky-linkage
LINKAGE SECTION items remain allocated between invocations
-fmove-ibm
MOVE operates as on IBM (left to right, byte by byte)
-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' for NUMERIC test of signed PACKED DECIMAL field
-fprogram-name-redefinition
program names don't lead to a reserved identifier
-faccept-update
set WITH UPDATE clause as default for ACCEPT dest-item, instead of WITH NO UPDATE
-faccept-auto
set WITH AUTO clause as default for ACCEPT dest-item, instead of WITH TAB
-fconsole-is-crt
assume CONSOLE IS CRT if not set otherwise
-fno-echo-means-secure
NO-ECHO hides input with asterisks like SECURE
-fline-col-zero-default
assume a field DISPLAY starts at LINE 0 COL 0 (i.e. at the cursor), not LINE 1 COL 1
-fdisplay-special-fig-consts
special behaviour of DISPLAY SPACE/ALL X'01'/ALL X'02'/ALL X'07'
-fbinary-comp-1
COMP-1 is a 16-bit signed integer
-fnumeric-pointer
POINTER is 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 ASSIGN DYNAMIC does not match any data item

-fcomment-paragraphs=<support>
comment paragraphs in IDENTIFICATION DIVISION (AUTHOR, DATE-WRITTEN, ...)
-fmemory-size-clause=<support>
MEMORY-SIZE clause

-fmultiple-file-tape-clause=<support> MULTIPLE-FILE-TAPE clause

-flabel-records-clause=<support>
LABEL-RECORDS clause
-fvalue-of-clause=<support>
VALUE-OF clause
-fdata-records-clause=<support>
DATA-RECORDS clause
-ftop-level-occurs-clause=<support>
OCCURS clause on top-level
-fsame-as-clause=<support>
SAME AS clause
-ftype-to-clause=<support>
TYPE TO clause
-fusage-type=<support>
USAGE type-name
-fsynchronized-clause=<support>
SYNCHRONIZED clause
-fspecial-names-clause=<support>
SPECIAL-NAMES clause
-fgoto-statement-without-name=<support>
GOTO statement without name
-fstop-literal-statement=<support>
STOP-literal statement

-fstop-identifier-statement=<support> STOP-identifier statement

-fdebugging-mode=<support>
DEBUGGING MODE and debugging indicator

-fuse-for-debugging=<support> USE FOR DEBUGGING

-fpadding-character-clause=<support>
PADDING CHARACTER clause
-fnext-sentence-phrase=<support>
NEXT SENTENCE phrase
-flisting-statements=<support>
listing-directive statements EJECT, SKIP1, SKIP2, SKIP3
-ftitle-statement=<support>
listing-directive statement TITLE
-fentry-statement=<support>
ENTRY statement
-fmove-noninteger-to-alphanumeric=<support>
move noninteger to alphanumeric
-fmove-figurative-constant-to-numeric=<support>
move figurative constants to numeric
-fmove-figurative-space-to-numeric=<support>
move figurative constant SPACE to numeric
-fmove-figurative-quote-to-numeric=<support>
move figurative constant QUOTE to numeric
-fodo-without-to=<support>
OCCURS DEPENDING ON without to
-fsection-segments=<support>
section segments
-falter-statement=<support>
ALTER statement
-fcall-overflow=<support>
OVERFLOW clause for CALL
-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> HP COBOL octal literals (%377)

-facu-literals=<support>
ACUCOBOL-GT literals (#B #O #H #X)

-fword-continuation=<support> continuation of COBOL words

-fnot-exception-before-exception=<support>
NOT ON EXCEPTION before ON EXCEPTION

-faccept-display-extensions=<support> extensions to ACCEPT and DISPLAY

-frenames-uncommon-levels=<support>
RENAMES of 01-, 66- and 77-level items

-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 CONSTANT AS/FROM item
-fperform-varying-without-by=<support>
PERFORM VARYING without BY phrase (implies BY 1)
-freference-out-of-declaratives=<support>
references to sections not in DECLARATIVES from within DECLARATIVES
-fprogram-prototypes=<support>
CALL/CANCEL with 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 VALUE clause of numeric-edited items
-fincorrect-conf-sec-order=<support>
incorrect order of CONFIGURATION SECTION paragraphs

-fdefine-constant-directive=<support> allow >> DEFINE CONSTANT var AS literal

-ffree-redefines-position=<support>
REDEFINES clause not following entry-name in definition
-frecords-mismatch-record-clause=<support>
record sizes does not match RECORD clause
-frecord-delimiter=<support>
RECORD DELIMITER clause
-fsequential-delimiters=<support>
BINARY-SEQUENTIAL and LINE-SEQUENTIAL phrases in RECORD DELIMITER
-frecord-delim-with-fixed-recs=<support>
RECORD DELIMITER clause on file with fixed-length records

-fmissing-statement=<support> missing statement (e.g. empty IF / PERFORM)

-fzero-length-literals=<support>
zero-length literals, e.g. '' and ""
-fxml-generate-extra-phrases=<support>
XML GENERATE's phrases other than COUNT IN
-fcontinue-after=<support>
AFTER phrase in CONTINUE statement
-fgoto-entry=<support>
ENTRY FOR GOTO and GOTO ENTRY statements
-fassign-variable=<support>
ASSIGN [TO] variable in SELECT
-fassign-using-variable=<support>
ASSIGN USING/VARYING variable in SELECT
-fassign-ext-dyn=<support>
ASSIGN EXTERNAL/DYNAMIC in SELECT
-fassign-disk-from=<support>
ASSIGN DISK FROM variable in SELECT
-fvsam-status=<support>
VSAM status in FILE STATUS
where <support> is one of the following: '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>
special register to enable

Written by Keisuke Nishida, Roger While, Ron Norman, Simon Sobisch, Edward Hart Built Dec 23 2020 11:52:50 Packaged Dec 23 2020 10:51:50 UTC C version "8.3.0"

Report bugs to: bug-gnucobol@gnu.org or (preferably) use the issue tracker via the home page.
GnuCOBOL home page: <https://www.gnu.org/software/gnucobol/>
General help using GNU software: <https://www.gnu.org/gethelp/>

Copyright © 2020 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

The full documentation for cobc is maintained as a Texinfo manual. If the info and cobc programs are properly installed at your site, the command
info gnucobol

should give you access to the complete manual.

December 2020 cobc (GnuCOBOL) 3.1.2.0

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.