Page History
7.20.1 DEF_ARRAY Parameters
|
|---|
Specifies the name that is to be assigned to the array. The following warnings and comments apply to the assignment of array names:The name must begin with the standard "#" symbol.
...
- 'TAB' can not be used as an array name.
|
|---|
Specifies the names of the numeric fields that will be used as indexes to reference individual elements in this array.At least one index name must be specified. Up to 50 may be specified.
...
Array index fields must not be overlaid on or by other fields (in any context).
|
|---|
Specifies from 1 to 100 fields that are to be grouped into a contiguous area so that they can be referenced by index via this array.
...
The OF_FIELDS parameter and the OVERLAYING parameter are mutually exclusive. You must specify one, but cannot specify both.
|
|---|
Specifies the name of a field that is to be fully or partially overlaid by this array. RDMLX fields may not be overlaid, nor overlay another field. When a full overlay is required, the total length (in bytes) of the array should match the total length (in bytes) of the field being overlaid.
...
Whether a full or partial overlay is required, you must NOT define the array so that it goes beyond the last position of the field being overlaid. Failure to observe this rule will cause unpredictable results.
The field that is referenced by this parameter must NOT itself be overlaid onto another field by using the TO_OVERLAY parameter of the DEFINE or OVERRIDE commands.
The OVERLAYING parameter and the OF_FIELDS parameter are mutually exclusive. You must specify one, but cannot specify both.
|
|---|
Specifies the type of data storage to be used within the array. Valid types are:
...
Do NOT specify this parameter when you use the OF_FIELDS parameter. Its value is automatically deducted from the type of field(s) specified in the OF_FIELDS parameter.
|
|---|
Specifies the total number of entries the array will contain. Any integer value in the range 1 to 9999 is valid.
Do NOT specify this parameter when you use the OF_FIELDS parameter. Its value is automatically deducted from the number of field(s) specified in the OF_FIELDS parameter.
|
|---|
Specifies the total length of each individual entry in the array.
...
Do NOT specify this parameter when you use the OF_FIELDS parameter. Its value is automatically deduced from the length of the field(s) specified in the OF_FIELDS parameter.
|
|---|
Specifies the total number of decimal positions (ie: digits, not bytes) that each numeric array entry should contain.
...