The redefinition option used with
DEFINE DATA LOCAL
,
DEFINE DATA
PARAMETER
, DEFINE
DATA INDEPENDENT
, DEFINE DATA CONTEXT
and
DEFINE DATA OBJECT
has the following syntax:
REDEFINE
field-name |
level | rgroup | |||||
rfield (format-length [/array-definition]) | |||||||
FILLER
nX |
This document covers the following topics:
For an explanation of the symbols used in the syntax diagram, see Syntax Symbols.
A redefinition may be used to redefine a group, a view, a DDM field or a single field/variable (that is a scalar or an array).
Notes:
See also Redefining Fields in the Programming Guide.
Handles, X-arrays and dynamic variables cannot be redefined and cannot be contained in a redefinition clause.
A group that contains a handle, X-array or a dynamic variable can only be redefined up to - but not including or beyond - the element in question.
field-name | The name of the group, view, DDM field or single field that is being redefined. |
---|---|
level | Level number is a 1- or 2-digit number in the range from 01 to 99 (the leading zero is optional) used in conjunction with field grouping. Fields assigned a level number of 02 or greater are considered to be a part of the immediately preceding group which has been assigned a lower level number. |
rgroup |
The name of the group resulting from the redefinition. Note: |
rfield |
The name of the field resulting from the redefinition. Note: |
format-length | The format and length of the resulting field (rfield). |
array-definition | With an array-definition, you define the lower and upper bounds of dimensions in an array-definition. See Array Dimension Definition. |
FILLER nX | With this notation, you define n filler bytes - that is, segments which are not to be used - in the field that is being redefined. The definition of trailing filler bytes is optional. |