Almost all the options have a default value. This automatically applies if the user does not explicitly specify an alternative. If all the default values of the system are to be used as options, COMOPT entries are superfluous.
The following table summarizes all COMOPT operands that can be used to control the compiler.
The following points refer to the representation of the statement formats:
If an operand can be abbreviated, the short form is indicated below its full designation (e.g. ACC-L-T-U for ACCEPT-LOW-TO-UP). The equal sign must be specified between the operand and the value in every case.
The default operand values are either shown underlined in the format or mentioned explicitly in the summarized description of the function.
In the “Function” column, under the keyword “SDF option”, you will find the short form of the SDF operand equivalent of the respective COMOPT operand. If there is no equivalent SDF operand, this is indicated by a dash.
Operand format | Function | |||||||||
ACCEPT-LOW-TO-UP={YES/NO} ACC-L-T-U | specifies whether letters entered in lowercase are to be converted to uppercase when an ACCEPT statement is executed. The conversion is performed only if the input is typed in at the terminal. SDF option: | |||||||||
ACTIVATE-WARNING-MECHANISM={YES/NO} ACT-W-MECH | specifies whether the existence of
that are detected in the program during compilation should be identified in the diagnostic listing by means of a message of severity code F. Note RESET-PERFORM-EXITS = NO In addition, the operand MINIMAL-SEVERITY=I is set in this case in order that messages of severity code F can also be listed. SDF option: | |||||||||
ACTIVATE-XPG4-RETURNCODE= {YES/NO} | specifies that, after a subprogram is called, its function value (register 1) is available in the COBOL special register RETURN-CODE. SDF option: | |||||||||
ALIGN-LLM-PAGE={YES/NO} A-L-P | specifies whether CSECTs in the generated module should be aligned on the page (YES) or double word boundary (NO). Note SDF option: | |||||||||
CHECK-CALLING-HIERARCHY={YES/NO} CHECK-C-H | specifies whether the calling hierarchy should be checked. A program in which the statements CALL identifier and/or CANCEL are used, must be compiled using SDF option: | |||||||||
CHECK-DATE={YES/NO} CHECK-D | specifies whether or not the compiler outputs a note concerning two-digit year values in the case of SDF option: | |||||||||
CHECK-FUNCTION-ARGUMENTS={YES/ NO } CHECK-FUNC | causes function arguments to be checked for validity and a message to be issued by the runtime system when errors occur. SDF option: | |||||||||
CHECK-PARAMETER-COUNT={YES/ NO } CHECK-PAR-C | specifies whether the number of parameters passed should be compared with the number of parameters expected when a COBOL subprogram is called. This does not work for subprograms called via an ENTRY. SDF option: | |||||||||
CHECK-REFERENCE-MODIFICATION = {YES/ NO CHECK-REF | determines whether the runtime system should verify compliance with data-item limits for identifiers subject to reference modification. SDF option: | |||||||||
CHECK-SCOPE-TERMINATORS={YES/ NO } CHECK-S-T | checks the syntax of the statements in the PROCEDURE DIVISION for correct scope termination. SDF option: | |||||||||
CHECK-SOURCE-SEQUENCE={YES/ NO } CHECK-S-SEQ | determines whether record pairs that are found not to be in ascending order should be identified in the diagnostic listing by an error message of severity code 0. SDF option: -- | |||||||||
CHECK-TABLE-ACCESS={YES/NO} CHECK-TAB | determines whether the runtime system should verify compliance with table limits (both for subscripts and for indexing). SDF option: | |||||||||
CONCATENATE-XML-LINES={YES/NO} C-X-L | determines whether the line feed caused by the record structure of a file(which contains an XML document) is to be supplied to the parser as an end-of-line character. SDF option: | |||||||||
CONTINUE-AFTER-MESSAGE={YES/NO} CON-A-MESS | determines whether the runtime system should be continued or terminated following specific COB91 messages. SDF option: | |||||||||
DEFAULT-CALL-CONVENTION={COBOL/ COMPATIBLE} DEF-C-C | COMPATIBLE is assumed as the default value for the CALL-CONVENTION directive. SDF option: | |||||||||
ELABORATE-SEGMENTATION={YES/NO} | If NO is specified, segmentation-related language elements are ignored (SEGMENT-LIMITclause, segment numbers in section header). Warnings are output. If YES is specified, compiler directives are ignored which apply during the compilation phase and are specified within a compilation unit. YES supports segmentation. However, the compilation is aborted with a message if the program contains nested compilation units and non-fixed segments. If this combination does not exist, only segmentation-related language elements are rejected with warnings. SDF option: | |||||||||
ENABLE-COBOL85-KEYWORDS-ONLY={YES / NO} | If YES is specified, only the keywords defined for COBOL85 are reserved. The additional keywords reserved by COBOL2000 can then be used as file names. SDF option: | |||||||||
ENABLE-UFS-ACCESS={YES/NO} Not available in COBOL2000-BC! | specifies whether the compiler is to generate an object which is also capable of processing files from the POSIX file system. SDF option: | |||||||||
ENABLE-XML-PROCESSING={YES/NO} | If NO is specified, the new statements for processing XML documents are not available. The keywords reserved for this purpose can then be used as data names. SDF option: | |||||||||
EXPAND-COPY={YES/NO} EXP-COPY | controls whether COPY elements inserted in the compilation unit are printed in the source listing. SDF option: | |||||||||
EXPAND-SUBSCHEMA={YES/NO} EXP-SUB | controls whether the Sub-schema Section of the compilation unit is logged on the source listing. SDF option: | |||||||||
FLAG-NONSTANDARD={YES/NO} | In the diagnostic listing, all non-standard language extensions are flagged with F. RESET-PERFORM-EXITS = NO SDF option: | |||||||||
FLAG-OBSOLETE={YES/NO} | In the diagnostic listing, all obsolete language extensions are flagged with F. RESET-PERFORM-EXITS = NO SDF option: | |||||||||
GENERATE-INITIAL-STATE={YES/NO} GEN-INIT-STA | specifies whether the compiler should make arrangements to return the program to its initial state. SDF option: | |||||||||
GENERATE-LINE-NUMBER={YES/NO} GEN-L-NUM | determines whether the COB9101 message is output instead of the COB9102 message. The COB9102 message is supplemented by the source line number (generated by COBOL2000) of the statement being executed when the message was issued. SDF option: | |||||||||
GENERATE-LLM={YES/NO} GEN-LLM | defines the module format for the module to be generated. If YES is specified, a link-and-load module (LLM) is generated; if NO is specified, an object module (OM) is generated.These specifications are ignored if MODUL-OUTPUT=<c-string...> has been specified. SDF option: | |||||||||
GENERATE-SHARED-CODE={YES/NO} GEN-SHARE | specifies whether the Procedure Division code (without DECLARATIVES) is written to a separate code module. The name for this module is program name, shortened to 7 characters if necessary, with appended “@”. SDF option: | |||||||||
IGNORE-COPY-SUPPRESS={YES/NO} IGN-C-SUP | determines whether or not existing COPY elements with the SUPPRESS option in the compilation unit should be listed in the source listing . SDF option: | |||||||||
IGNORE-EXTRA-ALTERNATE-KEYS={YES/ NO } IGN-EXT-ALTKEY | determines whether or not secondary keys which are defined only in the catalog entry but not in the program are to be ignored for indexed files and no error message output in the case of OPEN INPUT. SDF option: | |||||||||
IGNORE-LINE-SEQUENTIAL={YES/NO} | specifies whether the compiler is to ignore LINE in SELECT clauses and process LINE SEQUENTIAL files as if they are with SEQUENTIAL organization. If default NO is specified, the compiler processes sequential files in accordance with their declarations. SDF option: | |||||||||
IGNORE-OPTION-DIRECTIVES={YES/NO} IGN-O-DIR | determines whether or not >>IMP directives which apply for the compiler options (LISTING-OPTIONS, COMPILER-ACTION and RUNTIME-ERRORS) are ignored. SDF option: | |||||||||
INHIBIT-BAD-SIGN-PROPAGATION={YES/NO} | NO enables faster code to be generated when one data item is transferred to another, and both items are numerical and described with USAGE DISPLAY. No code is generated which would prevent encoded operational signs which do not match the PICTURE clause from being transferred. | |||||||||
KEEP-XML-NAMES={YES/NO} | specifies whether the statement XML GENERATE is to transfer data item names from the source code to the XML document without any change (YES) or converted to upper case (NO). SDF option: | |||||||||
LIBFILES= (list-id[,list-id]...) | determines which compilation protocols are to be created and output to a PLAM library.
The requested listings are processed from left to right. The value set last applies to the listing. For details on the possible truncation of names, see section "LISTING option". The PLAM library must be assigned with the ADD-FILE-LINK command via the link name LIBLINK. If no library name is assigned, the compiler stores the requested listings in the default library PLIB.COBOL.program-name. SDF option: | |||||||||
LINE-LENGTH=132 / 119..172 LINE-L | specifies the maximum number of characters that are printed per line in the compiler listings. SDF option: | |||||||||
LINES-PER-PAGE=64 / 20..128 LINES | specifies the maximum number of lines that are printed in the compiler listings per page. A page throw is effected as soon as the specified number of lines is reached. SDF option: | |||||||||
LISTFILES=(list-id[,list-id]...) | specifies which compiler listings are to be created and output to cataloged files.
For more information, read the description of COMOPT LIBFILES, which is similar. SDF option: | |||||||||
MARK-NEW-KEYWORDS={YES/NO} M-N-K | marks keywords from the future standard in the diagnostic listing with a message with severity code I.The value YES can only be specified if ENABLE-COBOL85-KEYWORDS-ONLY is also set to YES. SDF option: | |||||||||
MAXIMUM-ERROR-NUMBER=integer MAX-ERR | specifies from what error number onwards (depending on the MINIMAL-SEVERITY phrase) compilation should be aborted. SDF option: | |||||||||
MERGE-DIAGNOSTICS=YES/NO M-DIAG | “merges” all error messages that occurred during compilation with the source listing. For merging to function correctly, the source listing should not contain more than 65535 source lines (see section "Source listing for a compilation unit"). SDF option: | |||||||||
MERGE-REFERENCES={YES/NO} M-REF | extends the source listing with specifications on the address and length of definitions and cross-references to references or definitions. SDF option: | |||||||||
MERGE-STATEMENT-ADDRESS={YES/NO} M-STMT | causes the address of the first machine instruction which was generated for this purpose to be entered in the source listing for statements . SDF option: | |||||||||
MINIMAL-SEVERITY={I/0/1/2/3} MIN-SEV | suppresses messages in the diagnostic listing if their severity codes are less than the specified value. SDF option: | |||||||||
MODULE={*OMF/libname} | specifies where the object module that is generated during compilation is to be output. SDF option: | |||||||||
MODULE-ELEMENT=element-name MODULE-ELEM | specifies the name of the element under which an LLM is to be stored in the PLAM library. SDF option: | |||||||||
MODULE-VERSION=version MODULE-VERS | enables the assignment of a version designation to the element which contains the module generated during compilation. SDF option: | |||||||||
OPTIMIZE-CALL-IDENTIFIER={YES/NO} O-C-I | enables repeated calls for the same subprogram to be processed via CALL identifier without calling system interfaces (this is possible for the first 100 subprograms to be called) SDF option: | |||||||||
PERMIT-STANDARD-DEVIATION={YES/NO} P-S-D | specifies whether
SDF option: | |||||||||
PRINT-DIAGNOSTIC-MESSAGES={YES/NO} PRI-DIAG Not available in COBOL2000-BC! | makes it possible to have all COBOL2000 error messages listed. Compilation is not carried out in this case. SDF option: | |||||||||
REDIRECT-ACCEPT-DISPLAY={YES/NO} | causes the system files SYSDTA and SYSOUT to be assigned instead of system files SYSIPT and SYSLST (defaults) for ACCEPT and DISPLAY statements without FROM and UPON phrases. SDF option: | |||||||||
REPLACE-PSEUDOTEXT={YES/NO} REP-PSEUDO | determines how COPY elements are to be divided up into individually replaceable text words. If NO is specified, the separators colon, open brackets, close brackets and pseudotext delimiter do not act as separators for text words and are not independent text words. One particular effect of this is that no replacements are made within brackets in mask strings. If NO is specified, the REPLACE statement may not be used. The options in the REPLACING clause are limited to the replacement of a single text word by a text word or an identifier. Hexadecimal and national literals are not recognized as single text words. COPY elements may not contain COPY statements. REPLACE-PSEUDOTEXT=NO is not supported for free format. SDF option: -- | |||||||||
RESET-PERFORM-EXITS={YES/NO} RES-PERF | specifies whether the control mechanisms for all PERFORM statements are
SDF option: -- | |||||||||
ROUND-FLOAT-RESULTS-DECIMAL={YES/NO} ROUND-FLOAT | specifies whether floating-point data items are to be rounded to 7 (COMP-1) or 15 (COMP-2) decimal places before being transferred to fixed-point items. The option is only effective if the receiving item has been defined with fewer than 19 decimal digits. SDF option: -- | |||||||||
SEPARATE-TESTPOINTS={YES/NO} SEP-TESTP Not available in COBOL2000-BC! | specifies whether a separate address is to be generated for all paragraph and section headings in the PROCEDURE DIVISION for debugging with AID. SDF option: | |||||||||
SET-FUNCTION-ERROR-DEFAULT={YES/NO} S-F-E-D | causes function arguments to be checked for validity and an appropriate return code to be assigned to any function in which a corresponding error occurs. SDF option: | |||||||||
SHORTEN-OBJECT={YES/NO} SHORT-OBJ Not available in COBOL2000-BC! | specifies whether only ESD information should be listed in the requested object listing. SDF option: -- | |||||||||
SHORTEN-XREF={YES/NO} SHORT-XREF | determines whether the desired cross-reference listing should be shortened by including only data names and procedure names addressed in the program. SDF option: | |||||||||
SORT-EBCDIC-DIN={YES/NO} SORT-E-D | enables selection of the EBCDIC-DIN (ED) format for SORT (see “Sort” manual [6] ); among other things, characters with an umlaut, such as ä, ö or ü, are treated as AE, OE or UE during sort operations. SDF option: | |||||||||
SORT-MAP={YES/NO} | enables output of the locator map listing from the compilation unit, sorted by symbolic names in ascending order. The locator map listing comprises lists for data, section, and paragraph names. SDF option: | |||||||||
SOURCE-ELEMENT=element SOURCE-ELEM | assigns a PLAM library element as the compilation unit to the compiler. The library must be assigned with an ADD-FILE-LINK command (using the link name SRCLIB) prior to compilation. SDF option: | |||||||||
SOURCE-VERSION=version SOURCE-VERS | indicates to the compiler which version of the element assigned with SOURCE-ELEMENT should be compiled. SDF option: | |||||||||
SUPPRESS-LISTINGS={YES/NO} SUP-LIST | suppresses output of the
listings when an error with a severity code >= 2 occurs. SDF option: | |||||||||
SUPPRESS-MODULE={YES/NO} SUP-MOD | permits generation of a module and expansion of the parameterized classes/interfaces used to be prevented when an error with a severity code >=2 occurs. SDF option: | |||||||||
SYMTEST={ALL/NO} Not available in COBOL2000-BC! | specifies the information that the compiler provides for the advanced interactive debugger AID (see “AID” manual [8]). SDF option: | |||||||||
SYSLIST=(list-id[,list-id]...) | defines which compiler listings are to be created and output to the SYSLST system file.
SDF option: | |||||||||
TERMINATE-AFTER-SEMANTIC={YES/NO} TERM-A-SEM | causes the compilation group to only be checked for syntax and semantic errors, without a module being generated. Only source and diagnostic listings can be output in this case. SDF option: | |||||||||
TERMINATE-AFTER-SYNTAX={YES/NO} TERM-A-SYN | causes the compilation group to only be checked for syntax errors, without a module being generated. Only source and diagnostic listings can be output in this case. SDF option: | |||||||||
TEST-VIRTUAL-NAMES={YES/NO} Not available in COBOL2000-BC! | specifies for SYMTEST=ALL whether the virtual names FILLERnn and structure SPECIAL-NAMES are to be generated for debugging with AID. SDF option: | |||||||||
TEST-WITH-COLUMN1={YES/NO} TEST-W-C Not available in COBOL2000-BC! | defines for SYMTEST=ALL whether the AID source references are to be formed with the help of sequence numbers (columns 1-6) from the compilation group. SDF option: | |||||||||
UPDATE-REPOSITORY={YES/NO} UPD-R | determines whether or not the interface of the currently compiled source text is placed in the external repository assigned with the link name REPOUT. SDF option: | |||||||||
USE-APOSTROPHE={YES/NO} USE-AP | controls the representation of the figurative “QUOTE” constants. |