NaturalONE Version 8.3.7
 —  Predefined Object Types in Predict  —

Defining Additional Attributes of Fields

If you choose Open from the context menu of a field, a window appears in which you can define additional attributes.

Only those types of additional attributes appear in the window that apply to the type of field. For example: the option Adabas security & Edit mask is not contained in the list when a DB2 index field is processed.

The additional attributes are described in the following sections:


3GL Specification

Specifications for 3GL

Attributes
Gr.structure

The field attribute Gr.structure is used to change the record layout generated from a PE/PC field.

If Gr.structure is set to N, all fields within a PE group are treated as multiple value fields. Setting Gr.structure to N prevents the format buffer for Adabas from becoming very large.

Gr.structure = N can only be specified for real fields in the deepest PE group (highest level number). For example: if there are 3 PE groups in the file on level 1, 4 and 6, only the PE groups on level 6 can be marked with Gr.structure = N.

If Gr.structure is set to blank, PE/PC groups are to be generated as groups which occur n times as a whole.

Justify
R When COBOL copy code is generated, the statement JUSTIFIED RIGHT is added for this field. Any data written to this field is then right-justified.
L Data will be left-justified. Default.
Synchronized
Applicable to fields of format I, F or B and length 1, 2, 4 or 8.
S When Assembler, COBOL or PL/I copy/include code or a record layout is generated, this field can be aligned on a half-word, word, or double-word boundary (speeding up arithmetic operations). This affects format buffer generation and the offsets of the fields in the record buffer. Slack-bytes are inserted into the record buffer by the assembler or compiler but they are built into any format buffer by Predict using space characters X.
Initialize with
Determines the initial value for generation. To be used instead of the standard value (zeros for a numeric field, blanks for an alphanumeric field).
S blank
L low value
H high value
Z zero
Q quote
F Fill with string specified in the parameter Init. value (mandatory). For example: if X is specified and the field length is 4, XXXX will be used for initialization.
blank Field will be initialized with the string specified in the field Init. value. If no Init. value is specified, no initialization is performed.
Init. value

If Initialize with is either F or blank a value used for initialization of a field must/can be specified.

Length and format of the Init value must be valid for the field. For binary fields hexadecimal constants such as FB0A are valid. Hexadecimal values can be specified in two ways:

  • if Format=B, hexadecimal values can be specified directly. Example: F0

  • if Format=A, hexadecimal values must be preceded by uppercase X or H and be enclosed in single quotes. Example: X'F0' or H'F0'

See also Condition Name and Value.

Indexed by String that is used when generating the COBOL INDEXED BY clause (only valid for fields of type MU/MC or PE/PC).
Depending on String used when generating the COBOL DEPENDING ON clause (only valid for fields of type MU/MC or PE/PC).

Top of page

Conditions

Attributes
Condition name

A value to be used when generating either equate data in Assembler copy code or a level 88 entry in COBOL copy code.

Up to 29,970 condition names can be entered. Each name needs at least one corresponding condition value. Using condition names can make logical conditions and assignments easier to handle.

FC
Figurative constant. Valid values:
S blank
L low value
H high value
Z zero
Q quote
F Fill with string specified in the parameter Condition. value. For example: if X is specified an the field length is 4, XXXX is used as condition value.
blank The string specified in the field Condition value is used.
Condition value

The length and format of this value must be valid for this field. This value must have a corresponding condition name.

Up to 29,970 condition values can be entered. If several values correspond to the same name, put the name before the first value and leave the name field blank before later values. THRU in the name field indicates a range of values ending with the value on that line and beginning with the value on the previous line.

Top of page

Field Name Synonyms

graphics/one-el-synonyms.png

Attributes
Field name synonyms Synonyms to be assigned to the field when definitions in the following programing languages are generated: Natural, COBOL, PL/I, BAL (Assembler), FORTRAN, PASCAL, ADA or C.

Top of page

Adabas Security and Edit mask

Adabas security

Attributes
Adabas Edit mask

The Adabas edit mask to be used for the field. Determines how numeric fields are to be edited.

Valid values for Edit mask rules used in the COBOL programming language:

E1...E15.

Edit mask is supported for compatibility reasons and for documentation purposes only.

See the section Format Buffer Syntax in the Adabas Command Reference documentation for more information.

Valid values for Date-Time Edit masks:
D Date.
T Time.
DT Datetime.
TS Timestamp.
NT Natural time.
ND Natural date.
UT Unix time.
XTS Unix timestamp.
blank None.

In Predict, fields with format D by default use Natural date (NATDATE) and fields with format T by default use Natural time (NATTIME) Edit masks.

The different Date-Time Edit masks require different minimum numeric field lengths.

Detailed information is given in section Date-Time Edit Mask Reference of the Adabas Mainframe documentation.

Time zone The time zone in which a timestamp is applied. Only available for fields using one of the following Adabas edit masks described above: DT, NT, TS, UT or XTS.
Daylight saving The daylight savings indicator can only be specified for date-time fields defined with the TZ option. Indicates whether daylight saving applies (Y) or not (N).
Security access level The Adabas access security level of the field.
Security update level The Adabas update security level of the field.
System field
Type of the system-generated field in Adabas. Only available for Adabas fields of type A.
Valid values:
JN Job name. For alphanumeric fields only. Length must be 8 or greater.
OU Open command user. For alphanumeric fields only. Length must be 8 or greater.
SI Session ID. For alphanumeric fields only. Length must be 28 or greater.
SU Session user. For alphanumeric fields only. Length must be 8 or greater.
T Time. For numeric fields only.

Top of page

DBMS Extensions

Applicable only to DB2 fields of type D or MT and to Adabas fields of type A.

graphics/one-el-baseextensions-hidden.png

Attributes
Use as security label

Specifies that the table column will contain security label values.

A table can have only one security label column. To define a table with a security label column, the primary authorization ID of the statement must have a valid security label, and the RACF SECLABEL class must be active. In addition, the following conditions are also required:

  • The data type of the column must be CHAR(8).

  • The subtype of the column must be SBCS.

  • The column must be defined with the NOT NULL and WITH DEFAULT clauses.

  • No field procedures, check constraints, or referential constraints are defined on the column.

  • An edit procedure is not defined on the table.

Refer to your DB2 documentation for further details.

Partitioning
Indicates for each implementation of a table in a SQL server, which field controls the partitioning. Valid values:
blank

Non-partitioning.

The current field is not a partitioning key and has no index.

T

Table partitioning key.

The table is data partitioned and the current field is the partitioning key. Additionally, it may have a non-partitioned index.

I

Index controlled key.

The table partitioning is controlled by a partitioning index. The current field must have an index defined; this is indicated by descriptor type D (index), P (primary key) or F (foreign index).

N

Non-partitioned secondary index.

The field has a non-partitioned index, but it is not the partitioning key.

P

Data partitioned secondary index (DPSI).

The field has a partitioned index, but it is not the partitioning key. Within the file a different field must be defined as partitioning key.

Q

Table partitioning key and DPSI.

The table is data partitioned and the current field is the partitioning key. In addition, a partitioned index is defined for the field.

Cluster index
Only available for descriptor type D (index), P (primary key) or F (foreign index).
Y The records (rows) in the DB2 table are stored in the sequence of this index. Valid for max. one index per table. A table contained in a partitioned tablespace must have one index marked as a clustered index, if the partitioning option Index controlled key is to be used.

Top of page

Field Procedure

Attributes
Procedure name Name of a field procedure (DB2 parameter FIELDPROC). See the Natural for DB2 documentation for more details.
Procedure parameter Parameters passed to the field procedure. See the Natural for DB2 documentation for more details.

Top of page

Derived Field Expression

Field expression

Applicable only to fields of type DV in files of the following types:

B Adabas SQL views
E DB2 views
IV Intermediate view
JV Ingres view
OV Oracle view
X General SQL
XV Informix view
YV Sybase view

The subquery of the file that contains the current field can specify a correlation name for any file whose fields it uses. The name of each field referenced in the expression must be qualified (preceded) by the correlation name of the file from which the field is taken, if a correlation namehas been specified for that file, or the ID of the file from which the field is taken, if no correlation name has been specified for it. The expression can include both comment lines (with /*, * or ** in the first two columns) and line comments (preceded by /*).

Example: A field which contains the annual salary:

   *
   * Field expression of a derived field
   *
   USER-TABLE1-SALARY * 12     /* SALARY FOR 12 MONTHS
   + CORRELATOR2-BONUS
   

Top of page

Index Definition - DB2

Definition of Index / Defaults of Using-/Free-Block

Index fields (descriptor type D, F or P) in a file of type D (DB2 table), are defined in the tab below.

Definition of index

Defaults of using/free block

Attributes
Definition of Index
Index name The name of the DB2 index. See Key or Index Fields in SQL Files - Superfields.
Cluster index
Y The records (rows) in the DB2 table are stored in the sequence of this index. Valid for max. one index per table. A table contained in a partitioned tablespace must have one index marked as a clustered index, if the partitioning option Index controlled key is to be used..
Bufferpool The buffer pool associated with the index.
Close option
Y The data sets supporting this index are closed when nobody uses the index.
Copy
Indicates whether the copy utility is allowed for the index.
Y Full image or concurrent copies allowed.
N Full image or concurrent copies not allowed.
Piece size

The maximum piece size for a non-partitioned index. Valid values:

0, 256, 512, 1024, 2048, 4096, 8192, 16384, 32768, 65536, 131072, 262144, 524288, 1048576, 2097152, 4194304.

Reverse scans
Specifies whether an index supports forward scans only or reverse scans of the index also.
Y Reverse scans allowed.
N Reverse scans not allowed. This is the default.
Padded
Specifies how varying-length string columns are to be stored in the index.
Y Padded.
N Not padded.
blank Not specified.
Unique where not null
Null value option. Specifies whether a null value is allowed for a unique index. Valid values:
U Null allowed. Any two null values are taken to be unequal. If the key is a single column, that column can contain any number of null values, though its other values must be unique.
R Not null. Any two null values are taken to be equal. For example, if the key is a single column, that column can contain no more than one null value.
blank Determined by gener. Null value option is set via default server settings in Predict.
Compression
Specifies whether compression for index data will be used.
Y Compression is used.
N No compression is used. This is the default.
Defaults of Using- and Free-Block
VSAM catalog name Name of the VSAM catalog for the index. The parameter VSAM catalog name must be specified if data sets are already defined for the index.
Storagespace Storagespace where DB2 defines the data sets for the index (optional). If no storagespace is specified, DB2 uses the default storagespace.
Primary allocation Minimum primary space allocation (in Kbyte) for DB2-defined index data sets. A value specified in this field is stored only if the attribute storage group has been specified.
Secondary allocation Minimum secondary space allocation (in Kbyte) for DB2-defined index data sets. A value specified in this field is stored only if the attribute storage group has been specified.
Erase option
Y The DB2-defined data sets are to be erased (filled with nulls) when the index is dropped.
A value specified in this field is stored only if the attribute Storage group has been specified.
Free pages A number from 0 to 255 which indicates that one page is to be left free each time this number of pages is used when the load operation creates index entries or when the index is reorganized.
Zero indicates that no pages are to be left free.
Percentage free A number from 0 to 99: the percentage of each page to be left as free space when index entries are created by a load operation or when the index is reorganized.
GBPCACHE
Only relevant in a data sharing environment. Specifies what pages of the table space or partition are written to the group buffer pool.
Leave this field blank or enter:
C Changed. Only pages that have been changed are written to the group buffer pool.
A All pages are written.
N No pages are written to the group buffer pool.

Partition definitions

For a partitioned index (a cluster index for a table in a partitioned table space), the following tab is displayed. Each partition can then be defined in accordance with the Default values of using- and free-block (see description above).

Note:
The data displayed in this screen depend on the values selected in the Partitioning field of the DBMS extensions screen.

To define a new partition, use the New button. When you have defined more than one partition, a scroll bar is available. To go to a specific partition, use the scroll bar. To delete the currently displayed partition, choose the Delete button.

Partition definitions

Attributes
Limit value

The highest value of the index key in this partition.

At least one constant must be used and as many constants as there are columns in the key can be specified.

The concatenation of all the constants is the highest value of the key in this partition of the index.

Note:
No checking is performed here.

All other attributes are described above.

Top of page

Default value

This additional attribute is only applicable for fields in

Attribute
Default name The default specified here is used in the CREATE TABLE statement. Sybase naming conventions apply. See Naming Conventions for SQL Objects.

Note:
For Sybase, a default is an object in its own right. For other SQL systems, a default value is specified in the CREATE TABLE statement (not null with default default_expression). For Informix no default name is allowed.

Default expression An SQL expression can be specified between the angled brackets. This expression determines the default value, for example a constant or function. If specified, this value is always used by the function Generate CREATE statement.

Top of page

Constraint name

Depending on the field definition, up to four constraint names can be specified.

graphics/one-el-baseextensions-hidden.png

Attributes
Check constraint Constraint name in the respective SQL system for the fact that a linked verification of status S exists.
Primary key Constraint name for the fact that the field is a primary key.
Unique Constraint name for the fact that a unique constraint exists (indicated with U in column Unique option of the field object in Predict).
Null/Not null Constraint name for the fact that the Null or Not null default option is set to Y.

Top of page

Identity definition / Change log

These additional attributes are only applicable for fields in DB2 tables.

Identity definition

The following additional attributes are only applicable for fields of type

Identity definition

Attributes
Identity Specifies whether the column is an identity column for the table.
Generated
Indicates whether DB2 generates values for the column. Valid values:
A Always
D By default
blank None
Start value Specifies the first value for the identity column.
Increment value Specifies the interval between consecutive values of the identity column.
Cache Specifies whether to keep preallocated values in memory.
Cycle Specifies that values continue to be generated for this column after the maximum or minimum value has been reached.
Min value Specifies the numeric constant that is the minimum value that is generated for this identity column.
No minvalue Specifies whether or not a minimum end point of the range of values for the identity column has been set.
Max value Specifies the numeric constant that is the maximum value that is generated for this identity column.
No maxvalue Specifies whether or not a maximum end point of the range of values for the identity column has been set.

Change log

The following additional attributes are only applicable for fields of type

Attributes
Change log Specifies whether the column is a change log column for the table.
Generated
Indicates whether DB2 generates values for the column. Valid values:
A Always
D By default
blank None

Top of page

Platform Compatibilities

The following topics are covered:

No Blank Compression

This additional attribute is only applicable for Adabas fields with format A, AV or LO. The option No Blank Compression controls that trailing blanks are suppressed when a value is stored.

Identity definition

Top of page

Base Extensions

The following topics are covered:

Fractional of Seconds and Time Zone

These additional attributes are applicable for DB2 and Oracle table fields with format TS.

Fractional of seconds

Attributes
Fractional of seconds A timestamp value can include a precision of fractional seconds in the range from 0 to 12 (Oracle 0-9). For DB2, if no value is entered, the default value 6 is taken.
Time zone Provides information on the time difference in hours and minutes between the local time and Coordinated Universal Time (UTC). Adds an additional time zone offset value to the local timestamp value in the format +HH:MM (ahead of UTC) or -HH:MM (behind UTC).

Inline Length

This additional attributes is applicable for DB2 LOB fields.

Attributes
Inline length For BLOB, CLOB and DBCLOB columns. Specifies the maximum number of bytes that are stored in the base table space for the column. Must be between 0 and 32680 for a BLOB or CLOB column and between 0 and 16340 for a DBCLOB column..

Generated Expression

These additional attributes are applicable for DB2 table fields with formats A, AL and AV.

Generated expression

Attributes
Generated expression

For fields of DB2 tables (field types A, AL and AV) you can specify an as-generated-expression-clause.

The value provided in Generated expression is the expression that is evaluated by DB2 when generating the value of the field. Valid values:

DC Data change operation. Equivalent DB2 expression: DATA CHANGE OPERATION
CC Client accounting. Equivalent DB2 expression: CURRENT CLIENT_ACCTNG
CN Client application name. Equivalent DB2 expression: CURRENT CLIENT_APPLNAM
CT Client correlation token. Equivalent DB2 expression: CURRENT CLIENT_CORR_TOKEN
CU Client user ID. Equivalent DB2 expression: CURRENT CLIENT_USERID
CW Client workstation name. Equivalent DB2 expression: CURRENT CLIENT_WRKSTNNAME
CS Client server. Equivalent DB2 expression: CURRENT SERVER
CI SQL ID. Equivalent DB2 expression: CURRENT SQLID
SU Session user. Equivalent DB2 expression: SESSION_USER
PN Package name. Equivalent DB2 expression: SYSIBM.PACKAGE_NAME
PS Package schema. Equivalent DB2 expression: SYSIBM.PACKAGE_SCHEMA
PV Package version. Equivalent DB2 expression: SYSIBM.PACKAGE_VERSION
blank None.

Top of page