COMPOPT [option=value
...]
|
This system command is used to set various compilation options. The options are evaluated when a Natural object is compiled.
If you enter the COMPOPT command without any
options, a screen is displayed where you can enable or disable the options
described below.
The default settings of the individual options are set with the
corresponding keyword subparameters of the parameter macro
NTCMPO
in the Natural parameter module or in the profile parameter
CMPO. When
you change the library, the COMPOPT options are
reset to their default values.
This document covers the following topics:
COMPOPT |
If you issue the COMPOPT system
command without options, the Compilations
Options screen
appears. The keywords available there are described below.
|
COMPOPT
option=value |
The keywords for the individual options are described below. The setting assigned to a compiler option is in effect until you
issue the next |
You can specify compiler keyword parameters on different levels:
The default settings of the individual keyword parameters are
specified in the macro
NTCMPO in the Natural parameter
module.
At session start, you can override the compiler keyword parameters
with the profile parameter CMPO.
During an active Natural session, there are two ways to change the
compiler keyword parameters with the COMPOPT system
command: either directly using command assignment (COMPOPT
option=value)
or by issuing the COMPOPT command without keyword
parameters which displays the Compilation Options screen.
The settings assigned to a compiler option are in effect until you issue the
next LOGON command to another library. At
LOGON, the default settings set with the macro
NTCMPO and/or the profile parameter
CMPO (see above) will be resumed.
Example:
OPTIONS KCHECK=ON DEFINE DATA LOCAL 1 #A (A25) INIT <'Hello World'> END-DEFINE WRITE #A END
In a Natural object (for example: program, subprogram), you can set
compiler parameters (options) with the OPTIONS statement. Example:
OPTIONS KCHECK=ON WRITE 'Hello World' END
The compiler options defined in an OPTIONS statement will only
affect the compilation of this object, but do not update settings set with the
command COMPOPT.
The following options are available:
DB2ARRY - Support DB2 Arrays in SQL SELECT and INSERT Statements
DB2BIN – Generate SQL Binary Data Types for Natural Binary Fields
DB2PKYU – Place Primary Key Fields into the Natural DML UPDATE Statement
DB2TSTI – Generate SQL TIMESTAMP Data Type for Natural TIME Fields
PSIGNF - Internal Representation of Positive Sign of Packed Numbers
These options correspond to the keyword subparameters of the
CMPO profile parameter and/or the
NTCMPO parameter macro.
The CHKRULE option can be used to enable or disable a
validation check during the catalog process for maps.
ON |
When a Natural map is created, you may include fields which are
already defined inside another existing object. This works with nearly all
kinds of objects which allow you to define variables and also with DDMs. When
the included field is a database variable, it is a map editor built-in behavior
to automatically add (besides the included field) an additional
The function is similar to what is happening when an
When fields are incorporated from a DDM into a map, the
corresponding |
OFF |
INCDIR validation is disabled. This is the default
value.
|
The CPAGE option can be used to activate a conversion
routine which translates all alphanumeric constants (from the code page that
was active at compilation time into the code page that is active at runtime)
when the object is started at runtime.
See also CPAGE Compiler Option in the Unicode and Code Page Support documentation.
ON |
Code page support for alpha strings is enabled. |
OFF |
Code page support for alpha strings is disabled. This is the default value. |
A database field defined in a DDM is described by two names:
the short name with a length of 2 characters, used by Natural to communicate with the database (especially with Adabas);
the long name with a length of 3-32 characters (1-32 characters, if the underlying database type accessed is DB2/SQL), which is supposed to be used to reference the field in the Natural programming code.
Under special conditions, you may reference a database field in a Natural program with its short name instead of the long name. This applies if running in Reporting Mode without Natural Security and if the database access statement contains a reference to a DDM instead of a view.
The decision if a field name is regarded as a short-name reference
depends on the name length. When the field identifier consists of two
characters, a short-name reference is assumed; a field name with another length
is considered as a long-name reference. This standard interpretation rule for
database fields can additionally be influenced and controlled by setting the
compiler option DBSHORT to ON or OFF:
ON |
The usage of a short name is allowed for referencing a database field. However, a data base short name is not permitted in
general (even if
This is the default value. |
OFF |
A database field may only be referenced via its long name. Every database field identifier is considered as a long-name reference, regardless of its length. If a two character name is supplied which can only be found as a short name but not as a long name, syntax error NAT0981 is raised at compile time. This makes it possible to use long names defined in a DDM with 2-byte identifier length. This option is essential if the underlying database you access with this DDM is SQL (DB2) and table columns with a two character name exist. For all other database types (for example, Adabas), however, any attempt to define a long-field with a 2-byte name length will be rejected at DDM generation. Moreover, if no short-name references are used (what can be
enforced via |
Assume the following data base field definition in the DDM
EMPLOYEES:
| Short Name | Long Name |
|---|---|
AA |
PERSONNEL-ID |
Example 1:
OPTIONS DBSHORT=ON READ EMPLOYEES DISPLAY AA /* data base short name AA is allowed END
Example 2:
OPTIONS DBSHORT=OFF READ EMPLOYEES DISPLAY AA /* syntax error NAT0981, because DBSHORT=OFF END
Example 3:
OPTIONS DBSHORT=ON
DEFINE DATA LOCAL
1 V1 VIEW OF EMPLOYEES
2 PERSONNEL-ID
END-DEFINE
READ V1 BY PERSONNEL-ID
DISPLAY AA /* syntax error NAT0981, because PERSONNEL-ID is defined in view;
/* (even if DBSHORT=ON)
END-READ
END
The DB2ARRY option can be used to activate retrieval
and/or insertion of multiple rows from/into DB2 by a single SQL
SELECT or
INSERT statement
execution. This allows the specification of arrays as receiving fields in the
SQL SELECT and as source fields in the SQL INSERT
statement. If DB2ARRY is ON, it is no longer possible
to use Natural alphanumeric arrays for DB2 VARCHAR/GRAPHIC columns. Instead of
these, long alphanumeric Natural variables have to be used.
ON |
DB2 array support is enabled. |
OFF |
DB2 array support is not enabled. This is the default value. |
The DB2BIN option can be used to support the DB2 data
types BINARY and VARBINARY.
If DB2BIN is set to OFF, Natural binary
fields (format B(n)) are generated as
SQL data type CHAR (n<= 253) or
VARCHAR (253<n<=32767) like it
was in previous releases. DB2BIN=OFF is good for those who used
Natural binary fields like SQL CHAR fields. B2 and B4 are treated as SQL
SMALLINT and INTEGER.
If DB2BIN is set to ON, Natural binary fields
(format B(n)) are generated as SQL data
type BINARY (n<=255) or VARBIN
(255<n<=32767).
DB2BIN=ON is good for those who want to use SQL binary columns. B2
and B4 are also treated as SQL BINARY(2) and BINARY(4).
Note:
The setting of DB2BIN at the end of the compilation is
used for the complete Natural object. It cannot be changed for parts of a
Natural object.
ON |
SQL types BINARY and VARBIN are generated for Natural binary fields. |
OFF |
SQL types CHAR and VARCHAR are generated for Natural binary
fields, except B2 and B4. The latter are treated as SQL data types SMALLINT and
INTEGER.
This is the default value. |
Only applies if supported by the Natural for DB2 version installed at your site.
The DB2PKYU option can be used to update DB2 primary key
fields with a Natural DML UPDATE statement. DB2 primary key fields
are fields whose short names begin with the character O in the
DDM.
Note:
The setting of DB2PKYU at the end of the compilation is
used for the complete Natural object. It cannot be changed for parts of a
Natural object.
ON |
DB2 primary key fields are updated. DB2 primary key fields which are updated within the Natural
program are placed into the resulting DB2 positioned |
OFF |
DB2 primary key fields are not updated. DB2 primary key fields which are updated within the Natural
program are not placed into the resulting DB2 positioned This is the default value. |
This option is used to map Natural TIME
variables to the SQL TIMESTAMP data type instead of the default SQL TIME data
type.
ON |
SQL type TIMESTAMP is generated for Natural TIME
fields of Natural data format T.
This applies to the entire Natural object. You cannot generate
only part of an object with the |
OFF |
SQL type TIME is generated for Natural TIME
fields of Natural data format T.
This is the default value. |
Note:
A Natural TIME field only contains tenth of seconds as
precision while a SQL TIMESTAMP column can contain a much greater precision.
Thus, the TIMESTAMP value read from the SQL database may be truncated if
DB2TSTI=ON is set.
ON |
The compiler checks for the existence of an object that is
specified in an object calling statement, such as
FETCH [RETURN/REPEAT],
RUN [REPEAT],
CALLNAT,
PERFORM,
INPUT USING
MAP,
PROCESS PAGE
USING,
function
call,
helproutine
call.
The existence check is based on a search for the cataloged object
or for the source of the object when it is invoked by a It requires that the name of the object to be called/run is defined as an alphanumeric constant (not as an alphanumeric variable). Otherwise, Error Control for ECHECK=ON
The existence check is executed only when the object does not contain any syntax errors. The existence check is executed for every object calling statement. The existence check is controlled by the
Problems in Using the CATALL Command with
ECHECK=ON
When a If a GDAs, LDAs, PDAs, functions, subprograms, external subroutines, help routines, maps, adapters, programs, classes. Within objects of the same type, the alphabetical order of the name determines the sequence in which they are cataloged. As mentioned above, the success of the object calling statement is
checked against the compiled form of the called object. If the calling object
(the one which is being compiled and includes the object calling statement) is
cataloged before the invoked object, the Solution:
|
OFF |
No existence check is performed. This is the default setting. |
This option is used to store information on the structure of a GDA (global data area) to determine whether a Natural error is to be issued when an unchanged GDA is cataloged.
The GDA information (GDA signature) only changes when a GDA is modified. The GDA signature does not change when a GDA is (accidentally) cataloged but was not modified.
The signature of the GDA and the GDA signatures stored in all Natural objects referencing this GDA are compared at execution time, in addition to the time stamps of the objects.
ON |
GDA signatures are stored and compared during execution. Natural only issues an error message if the signatures are not identical. |
OFF |
GDA signatures are not stored. This is the default value. |
This option allows you to control Natural's internal generation of global format IDs so as to influence Adabas's performance concerning the re-usability of format buffer translations.
ON |
Global format IDs are generated for all views. This is the default value. |
VID |
Global format IDs are generated only for views in local/global data areas, but not for views defined within programs. |
OFF |
No global format IDs are generated. |
For details on global format IDs, see the Adabas documentation.
GFID=abccddee
| where | equals |
|---|---|
| a | x'F9' |
| b | x'22' or x'21' depending on DB statement |
| cc | physical database number (2 bytes) |
| dd | physical file number (2 bytes) |
| ee | number created by runtime (2 bytes) |
GFID=abbbbbb
| where | equals |
|---|---|
| a | x'F8' or x'F7' or x'F6'
where:
F6= |
| bbbbbbb | bytes 1-7 of STOD value |
Note:
STOD is the return value of the store clock machine instruction
(STCK).
ON |
Field declarations in an object will be checked against a set of critical Natural keywords. If a variable name defined matches one of these keywords, a syntax error is reported when the object is checked or cataloged. |
OFF |
No keyword check is performed. This is the default value. |
The section Performing a Keyword
Check (in the Programming Guide)
contains a list of the keywords that are checked by the KCHECK
option.
The section Alphabetical List of Natural Reserved Keywords (in the Programming Guide) contains an overview of all Natural keywords and reserved words.
This option supports the use of lower or mixed-case program sources on mainframe platforms. It facilitates the transfer of programs written in mixed/lower-case characters from other platforms to a mainframe environment.
ON |
Allows any kind of lower/upper-case characters in the program source. |
OFF |
Allows upper-case mode only. This requires keywords, variable names and identifiers to be defined in upper case. This is the default value. |
When you use lower-case characters with LOWSRCE=ON,
consider the following:
The syntax rules for variable names allow lower-case characters in subsequent positions. Therefore, you can define two variables, one written with lower-case characters and the other with upper-case characters.
Example:
DEFINE DATA LOCAL 1 #Vari (A20) 1 #VARI (A20)
With LOWSRCE=OFF, these variables are treated as
different variables.
With LOWSRCE=ON, the compiler is not case
sensitive and does not make a distinction between lower/upper-case characters.
This will lead to a syntax error because a duplicate definition of a variable
is not allowed.
Using the session parameter EM (Edit Mask) in an
I/O statement or in a MOVE
EDITED statement, there are characters which influence the
layout of the data setting assigned to a variable (EM
control characters), and characters which insert text fragments into the data
setting.
Example:
#VARI :='1234567890' WRITE #VARI (EM=XXXXXxxXXXXX)
With LOWSRCE=OFF, the output is
"12345xx67890", because for alpha-format variables
only upper-case X, H and circumflex accent (ˆ) sign can be used.
With LOWSRCE=ON, the output is
"1234567890", because an x character is treated like
an upper-case X and, therefore, interpreted as an EM
control character for that field format. To avoid this problem, enclose
constant text fragments in apostrophes (').
Example:
WRITE #VARI(EM=XXXXX'xx'XXXXX)
The text fragment is not considered an
EM control character, regardless of the
LOWSRCE settings.
Since all variable names are converted to upper-case characters with
LOWSRCE=ON, the display of variable names in I/O statements
(INPUT,
WRITE or
DISPLAY) differs.
Example:
MOVE 'ABC' to #Vari DISPLAY #Vari
With LOWSRCE=OFF, the output is:
#Vari
--------------------
ABC
With LOWSRCE=ON, the output is:
#VARI
--------------------
ABC
This option determines the maximum number of digits after the decimal point that the Natural compiler generates for results of arithmetic operations.
7,…,29 |
The value denotes the maximum number of digits after the
decimal point that the Natural compiler generates for results of arithmetic
operations.
The default value If higher precision is desired for intermediate results, the value should be increased. The setting of DEFINE DATA LOCAL 1 P (P1.15) END-DEFINE P := P + 0.1234567890123456 END See also Precision of Results of Arithmetic Operations in the Programming Guide. |
 |
Warning: Changing the value of the MAXPREC option
that is being used to catalog a Natural object may lead to different results,
even if the object source has not been changed. See example below. |
Example:
DEFINE DATA LOCAL 1 #R (P1.7) END-DEFINE #R := 1.0008 * 1.0008 * 1.0008 IF #R = 1.0024018 THEN ... ELSE ... END-IF
The value of #R after the computation and the execution of
the IF statement depend on the setting of
MAXPREC:
| Setting of MAXPREC Effective at Compile Time | Value of #R | Executed Clause of IF Statement |
|---|---|---|
MAXPREC=7 |
1.0024018 |
THEN clause
|
MAXPREC=12 |
1.0024019 |
ELSE clause
|
This option determines whether or not memory is allocated for unused
level-1 fields or groups defined locally (DEFINE DATA LOCAL).
ON |
Storage is allocated only for
|
OFF |
Data storage is allocated for all groups and fields declared locally. This is the default setting. |
ON |
The compiler checks the number, format, length and array index
bounds of the parameters that are specified in an object calling statement,
such as CALLNAT,
PERFORM,
INPUT USING
MAP, PROCESS PAGE
USING,
function
call,
helproutine
call. Also, the OPTIONAL feature
of the DEFINE DATA
PARAMETER statement is considered in the parameter check.
The parameter check is based on a comparison of the parameters of
the object calling statement with the It requires that
Otherwise, Error Control for PCHECK=ON
The parameter check is executed only when the object does not contain any syntax errors. The parameter check is executed for every object calling statement. The parameter check is controlled by the
Problems in Using the CATALL Command with
PCHECK=ON
When a If a GDAs, LDAs, PDAs, functions, subprograms, external subroutines, help routines, maps, adapters, programs, classes. Within objects of the same type, the alphabetical order of the name determines the sequence in which they are cataloged. As mentioned above, the parameters of the object calling statement
are checked against the compiled form of the called object. If the calling
object (the one which is being compiled and includes the object calling
statement) is cataloged before the invoked object, the Solution:
|
OFF |
No parameter check is performed. This is the default setting. |
ON |
The positive sign of a packed number is represented internally as H'F'. This is the default value. |
OFF |
The positive sign of a packed number is represented internally as H'C'. |
This option can be used to enable or disable the use of thousands
separators at compilation time. See also the profile and session parameter THSEPCH and the
section Customizing Separator
Character Displays (in the Programming
Guide).
ON |
Thousands separator used. Every thousands separator character that is not part of a string literal is replaced internally with a control character. |
OFF |
Thousands separator not used, i.e. no thousands separator control character is generated by the compiler. This is the compatibility setting. |
ON |
Each double quotation mark within a text constant is output as a single apostrophe. This is the default value. |
OFF |
Double quotation marks within a text constant are not translated; they are output as double quotation marks. |
Example:
RESET A(A5) A:= 'AB"CD' WRITE '12"34' / A / A (EM=H(5)) END
With TQMARK ON, the output is:
12'34 AB'CD C1C27DC3C4
With TQMARK OFF, the output is:
12"34 AB"CD C1C27FC3C4
This option determines whether the profile parameter TS (translate
output for locations with non-standard lower-case usage) is to apply only to
Natural system libraries (that is, libraries whose names begin with
"SYS", except SYSTEM) or to all user
libraries as well.
Natural objects cataloged with TSENABL=ON determine the
TS parameter even if they are located in a non-system
library.
ON |
The profile parameter TS applies to all
libraries.
|
OFF |
The profile parameter TS only applies to
Natural system libraries. This is the default value.
|
The following options are available:
These options correspond to the keyword subparameters of the
CMPO profile parameter and/or the
NTCMPO parameter
macro.
The LUWCOMP option checks whether the syntax of the
features provided since Natural for Mainframes Version
8.2 is also supported by Natural for UNIX Version 8.3 and Natural for Windows
Version 8.3. If any syntax incompatibilities
between the mainframe and UNIX or Windows are detected, compilation under
Natural for Mainframes Version 8.2 fails with an appropriate Natural error
message and reason code.
The following values are possible:
ON |
When a program is compiled, every attempt to use a syntax construction that is supported by Natural for Mainframes but not by Natural for UNIX or Natural for Windows is rejected with a NAT0598 syntax error and an appropriate reason code (see the following section). |
OFF |
No syntax check is performed. Any inconsistencies between the mainframe and UNIX or Windows are ignored. This is the default value. |
The following reason codes indicate which syntax parts are not supported by UNIX or Windows:
| Reason Code | Invalid Syntax on UNIX or Windows |
|---|---|
| 001 | A variable of the format P/N or a numeric
constant with more than 7 precision digits is defined.
Example: DEFINE DATA LOCAL 1 #P(P5.8) |
| 004 | Either of the following compiler options is
used:
Example: OPTIONS MAXPREC=10 |
| 007 | In a MOVE ALL statement, a
SUBSTR option is used for the source or target field.
Example: MOVE ALL 'X' TO SUBSTR(#A, 3, 5) |
| 011 | The ADJUST option is used in a
READ WORK FILE statement to auto resize an X-array field at
access.
Example: READ WORK FILE 1 #XARR(*) AND ADJUST |
| 012 | The field referenced in the REINPUT ...
MARK clause is supplied with a (CV=...) option.
Example: REINPUT 'text' MARK *#FLD (CV=#C) |
| 013 | System variables are referenced in the field
list of a WRITE WORK FILE statement.
|
| 014 | Within a
READ or
FIND statement,
|
| 015 | Either of the following statements is used: |
| 016 | The source field in a
SEPARATE statement was defined as an array.
Example: SEPARATE #TEXT(*) INTO ... |
| 017 |
The POSITION clause is used in a SEPARATE
statement.
|
| 019 | One of the following new system variables was used: |
ON |
The range of valid year values that match the YYYY mask
characters is 1582 - 2699 to make the MASK option compatible with
MOVE EDITED. If the profile parameter
MAXYEAR is set to 9999, the range of valid year values
is 1582 - 9999.
|
OFF |
The range of valid year values that match the YYYY mask
characters is 0000 - 2699. This is the default value. If the profile parameter
MAXYEAR is set to 9999, the range of valid year values
is 0000 - 9999.
|
ON |
Assignments of numeric variables where source and target have the same length and precision is performed as with Natural Version 2.2. |
OFF |
Assignments of numeric variables where source and target have the same length and precision is performed as with Natural Version 2.3 and above, that is they are processed as if source and target would have different length or precision. This is the default value. |