UpBuilding a Project > UpCOBOL Compiler > UpCompile Options Previous Next

Compile Option Details

When you select an option in the [Add Compiler Options] dialog box, another dialog box appears, enabling you to specify detailed information. This section explains the individual items of this detailed information.

ALPHAL Compiler Options

Specifies whether to treat lowercase letters in the source program as uppercase letters (ALPHAL) or not (NOALPHAL).
In the [Add Compiler Options] dialog box, select [ALPHAL] from [Compiler Options], and click [Add] to display the [ALPHAL Compiler Options] dialog box.

image

[Lower-case character usage]

Specifies how to treat lowercase letters in the source program. If [Take as upper-case] is selected, lowercase letters are treated as uppercase letters. If [Take as lower-case] selected, lowercase and uppercase letters are distinguished.
[Take as lower-case] is selected by default.

[All COBOL words and constant]

This option can be selected if [Take as upper-case] is specified for [ALPAHL].
[ALL]: Lowercase letters in program name literals and other literals in the CALL, CANCEL, ENTRY, and INVOKE statements are treated as uppercase letters.
[WORD]: Literals are treated as they are written.
[ALL] is selected by default.

BINARY Compiler Options

Specifies whether to allocate the basic items of binary data by the word-unit area length (2, 4, or 8) determined from the number of digits (BINARY (WORD)) or by byte-unit area length (1 to 8) (BINARY (BYTE)). Note that the handling of the leftmost bits of unsigned binary items can also be specified.
In the [Add Compiler Options] dialog box, select [BINARY] from [Compiler Options], and click [Add] to display the [BINARY Compiler Options] dialog box.

image

[Binary data item usage]

[BINARY (WORD,MLBON)]: The leftmost bit of an item allocated by word-unit area length is handled as a sign.

[BINARY (WORD,MLBOFF)]: The leftmost bit of an item allocated by word-unit area length is handled as a numeric value.
[BINARY (BYTE)]: The leftmost bit of an item allocated by byte-unit area length is handled as a sign.

CHECK Compiler Option

Specifies whether to use the CHECK function (CHECK) or not (NOCHECK). It also specifies the message display count (0 to 999999).
In the [Add Compiler Option] dialog box, select [CHECK] from [Compiler Options], and click [Add] to display the [CHECK Compiler Option] dialog box.

image

[CHECK function]

[CHECK]: The CHECK function is used.
[NOCHECK]: The CHECK function is not used.

[Number of messages to be displayed]

Specify the number of messages to be displayed.

[Check item]

[ALL]: NUMERIC, BOUND, ICONF, LINKAGE, and PRM, which are listed below, are all checked.
[NUMERIC]: Data is checked for data exceptions. A data exception occurs if a numeric item includes a value not suitable for the attribute or if the divisor in division is zero.

[BOUND]: Subscripts, indexes, and reference modifications are checked for range errors.
[ICONF]: Parameters of the INVOKE statement and formal parameters of the invoked method are checked for compatibility.
[LINKAGE]: A message is output if a difference is found in linkage.
[PRM]: Data items in which the USING/RETURNING clause is written are checked.

COPY Compiler Option

Specifies whether the library text built using the COPY statement is displayed (COPY) or not (NOCOPY). This option is valid only if the SOURCE compile option is specified.
In the [Add Compiler Option] dialog box, select [COPY] from [Compiler Option], and click [Add] to display the [COPY Compiler Option] dialog box.

image

[Library text output option]

[COPY]: The library text is displayed.
[NOCOPY]: The library text is not displayed.

DLOAD Compiler Option

Specifies whether to create programs in the dynamic program structure.
In the [Add Compiler Options] dialog box, select [DLOAD] from [Compiler Options], and click [Add] to display the [DLOAD Compiler Option] dialog box.

image

[Specify Program structure]

[DLOAD]: Programs are created in the dynamic program structure.
[NODLOAD]: Programs are created in a non-dynamic program structure.

FORMLIB Compiler Option

Specifies the folder of the screen form descriptor file from which a record definition is read from the screen form descriptor with the COPY statement with IN/OF XMDLIB specified.
In the [Add Compiler Options] dialog box, select [FORMLIB] from [Compiler Options], and click [Add] to display the [FORMLIB Compiler Option] dialog box.

image

[Screen form definition file folder]

Specify the folder of the screen form descriptor file.
Multiple folders can be specified if they are delimited with a semicolon.
Click [Browse]. The [Browse] dialog box appears, enabling you to select the folder specification method. Using the list displayed in the [Select] dialog box, specify the start location of the path of the folder. The [Browse Folder] dialog box that follows depends on the selection. Then, select the folder.

LIB Compiler Option

Specifies the storage location of a library file involved with use of the library function (COPY statement).
In the [Add Compiler Option] dialog box, select [LIB] from [Compiler Option], and click [Add] to display the [LIB Compiler Option] dialog box.

image

[Folder where the library texts exist]

Specify the folder of the library file.
Multiple folders can be specified if they are delimited with a semicolon.
Click [Browse]. The [Browse] dialog box appears, enabling you to select the folder specification method. Using the list displayed in the [Select] dialog box, specify the start location of the path of the folder. The [Browse Folder] dialog box that follows depends on the selection. Then, select the folder.

OPTIMIZE Compiler Option

Specifies whether to create a globally optimized target program. Note that a globally optimized target program is not created if this option and the TEST compile option are specified at the same time.
In the [Add Compiler Options] dialog box, select [OPTIMIZE] from [Compiler Options], and click [Add] to display the [OPTIMIZE Compiler Option] dialog box.

image

[Global Optimization]

[OPTIMIZE]: A globally optimized target program is created.
[NOOPTIMIZE]: No globally optimized target program is created.

PRINT Compiler Option

Specifies whether a compile list is to be output.
In the [Add Compiler Options] dialog box, select [PRINT] from [Compiler Options], and click [Add] to display the [PRINT Compiler Option] dialog box.

image

[Compiler listing Folder]

Specify a name for the compile list output file.
You can click [Browse] to select an existing folder.

RCS Compiler Option

Specifies the runtime code system.
In the [Add Compiler Option] dialog box, select [RCS] from [Compiler Option], and click [Add] to display the [RCS Compiler Option] dialog box.

image

[Runtime code set]

[ASCII]: ASCII is the runtime code system.
[UCS2]: Unicode is the runtime code system.

REP Compiler Option

Specifies the repository file input/output folder used during compilation. If the REP option is not specified, repository files are created in the folder containing the source file. The specified folder is also the folder whose repository files are to be read.
In the [Add Compiler Options] dialog box, select [REP] from [Compiler Options], and click [Add] to display the [REP Compiler Option] dialog box.

image

[Repository file input and output folder]

Specify the repository file input/output folder.
You can click [Browse] to select a folder.

REPIN Compiler Option

Specifies the repository input folder used during compilation. If repository files are stored in multiple folders, specify the folders while delimiting them with a semicolon (;). These folders are searched in the order specified.
In the [Add Compiler Option] dialog box, select [REPIN] from [Compiler Option], and click [Add] to display the [REPIN Compiler Option] dialog box.

image

[Repository file input folders]

Specify the repository file input folder.
Click [Browse]. The [Browse] dialog box appears, enabling you to select the folder specification method. Using the list displayed in the [Select] dialog box, specify the start location of the path of the folder. The [Browse Folder] dialog box that follows depends on the selection. Then, select the folder.

SAI Compiler Option

Specifies whether to output a source analysis information file. Normally, a source analysis information file is output to the same folder as that of the source program. Specify another output folder when you want to change the default output folder.
In the [Add Compiler Options] dialog box, select [SAI] from [Compiler Options], and click [Add] to display the [SAI Compiler Option] dialog box.

image

[Source analysis information file]

[SAI]: A source analysis information file is output.
[NOSAI]: No source analysis information file is output.

[Specification of source analysis information]

Specify the output folder for the relevant source analysis information file. This option can be specified when [SAI] is selected in [Source analysis information file].
Click [Browse]. The [Browse] dialog box appears, enabling you to select the folder specification method. Using the list displayed in the [Select] dialog box, specify the start location of the path of the folder. The [Browse Folder] dialog box that follows depends on the selection. Then, select the folder.

SHREXT Compiler Option

Specifies whether external data is shared by all threads (SHREXT) or not (NOSHREXT) if THREAD (MULTI) is specified.

In the [Add Compiler Option] dialog box, select [SHREXT] from [Compiler Option], and click [Add] to display the [SHREXT Compiler Option] dialog box.

image

[External data and files usage]

Select [Share between threads] or [Do not share between threads].

SRF Compiler Option

Specifies the reference format of the COBOL source file and library source program. Specify one of the following: fixed-length format, variable-length format, or free format.
In the [Add Compiler Option] dialog box, select [SRF] from [Compiler Option], and click [Add] to display the [SRF Compiler Option] dialog box.

image

[Source reference format]

For [Source program], select from [Fixed], [Variable], and [Free] as the reference format specified for COBOL source programs.
For [Library text], select from [Fixed], [Variable], and [Free] as the reference format specified for libraries.
The SRF value is initialized based on the editor settings.

SSIN Compiler Option

Specifies the input source of ACCEPT statement data of the ACCEPT/DISPLAY function.
In the [Add Compiler Option] dialog box, select [SSIN] from [Compiler Option], and click [Add] to display the [SSIN Compiler Option] dialog box.

image

[ACCEPT statement data input]

[SSIN]: A file is the data input source.
[SSIN(SYSIN)]: A console window is the data input source.

[Specification of Environmental variable]

Specify the name of the environment variable in which the input source file name is set.

SSOUT Compiler Option

Specifies the output destination of DISPLAY statement data of the ACCEPT/DISPLAY function.
In the [Add Compiler Option] dialog box, select [SSOUT] from [Compiler Option], and click [Add] to display the [SSOUT Compiler Option] dialog box.

image

[DISPLAY statement data output]

[SSOUT]: A file is the data output destination.
[SSOUT(SYSIN)]: A console window is the data output destination.

[Specify executable Environment variables]

Specify the name of the environment variable in which the output destination file name is set.

TAB Compiler Option

Specifies the tabbing unit: 4-column unit (TAB(4)) or 8-column unit (TAB(8)).
In the [Add Compiler Option] dialog box, select [TAB] from [Compiler Option], and click [Add] to display the [TAB Compiler Option] dialog box.

image

[Tab usage]

Specify whether to tab in units of 4 or 8 columns.
The default is the value set by the editor.

THREAD Compiler option

Specifies multithread (THREAD(MULTI)) or single thread (THREAD(SINGLE)) as an object file attribute.
In the [Add Compiler Option] dialog box, select [THREAD] from [Compiler Option], and click [Add] to display the [THREAD Compiler Option] dialog box.

image

[Specification to create multi thread program]

Specify [MULTI - thread] or [SINGLE - thread] as an object file attribute.

image

Each compile option can be added only once. Therefore, a compile option that has already been added is not displayed in the [Add Compiler Option] dialog box.


Previous Next

All Rights Reserved, Copyright (C) FUJITSU LIMITED 2003-2005