Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

RUNTIME-OPTIONS option

The parameters of this option control certain characteristics of the executable COBOL program.

Format

RUNTIME-OPTIONS = *STD / *PARAMETERS(...)


*PARAMETERS(...)


|

ACCEPT-STMT-INPUT = *UNMODIFIED / *UPPERCASE-CONVERTED


|

,FUNCTION-ERR-RETURN = *UNDEFINED / *STD-VALUE


|

,SORTING-ORDER = *STD / *BY-DIN


|

,ACCEPT-DISPLAY-ASSGN = *SYSIPT-AND-SYSLST / *TERMINAL


|

,ERR-MSG-WITH-LINE-NR = *NO / *YES


|

,ERROR-REACTION = *CONTINUATION / *TERMINATION


|

,ENABLE-UFS-ACCESS = *NO / *YES


|

,EXTRA-ALTERNATE-KEYS = *IGNORE / *STD


|

,XML-LINE-FEED = *INSERTED / *IGNORED


RUNTIME-OPTIONS = *STD
The preset default values of the PARAMETERS structure will be used.

RUNTIME-OPTIONS = *PARAMETERS(...)

ACCEPT-STMT-INPUT = *UNMODIFIED / *UPPERCASE-CONVERTED
If UPPERCASE-CONVERTED is specified, letters entered in lowercase in an ACCEPT statement will be converted to uppercase if the input is typed in from the terminal.

FUNCTION-ERR-RETURN = *UNDEFINED / *STD-VALUE
If STD-VALUE is specified, the value range, number, and length of function arguments are checked at runtime. If invalid argument values are detected, the appropriate return code for the error is assigned to the function in which the error occurs.

SORTING-ORDER = *STD / *BY-DIN
Specifying BY-DIN causes the SORT utility routine to perform the sort according to the DIN standard for EBCDIC; that is,

    • lowercase letters are equated to the corresponding uppercase letters

    • the character
      “ä” or “Ä” is identified with “AE”,
      “ö” or “Ö” is identified with “OE”,
      “ü” or “Ü” is identified with “UE” and
      “ß” is identified with “SS”.

    • digits are sorted before letters.

ERR-MSG-WITH-LINE-NR = *NO / *YES
If YES is specified, the message COB9102 is output instead of the COB9101 message and is supplemented by the compilation unit line number assigned by the compiler to the statement that was being executed when the message was output.

ACCEPT-DISPLAY-ASSGN = *SYSIPT-AND-SYSLST / *TERMINAL
Specifying *TERMINAL 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.

ERROR-REACTION = *CONTINUATION / *TERMINATION
By default (CONTINUATION), the program run will continue after the following messages are output:
COB9120 to COB9127, COB9131, COB9132, COB9134, COB9140, COB9144, COB9145 and COB9197.
If TERMINATION is specified, the aforementioned error conditions lead to abnormal program termination (see also section "Program termination").

ENABLE-UFS-ACCESS = *NO / *YES
If YES is specified, the compiler generates an object

    • that is capable of accessing the POSIX file system as a program

    • that can be further processed (linked) in the POSIX subsystem.

The chapter "COBOL2000 and POSIX" describes how to access a file from the POSIX file system and the conditions to which file processing is subject.

This operand is not available in COBOL-BC.

EXTRA-ALTERNATE-KEYS = *IGNORE / *STD
A prerequisite for processing an indexed file with secondary keys is, by default (STD), an identical description of the secondary keys in the program and in the file’s catalog entry. Specifying IGNORE means that an indexed file with secondary keys can be processed in read mode (OPEN INPUT) even if more keys are described in the file’s catalog entry than in the program.

XML-LINE-FEED = *INSERTED / *IGNORED
If INSERTED is specified, the record structure of a file containing an XML document remains visible while the document is processed: record changes are forwarded to the XML parser in the form of an end-of-line character.
If IGNORED is specified, the end of a file record remains invisible for the parser: the document appears like a single record in the file.
This parameter has no effect for XML documents which are provided in the working memory.

This parameter refers only to the record structure of a file, but not to end-of-line characters which are contained in a file record.