Enform Plus Reference Manual

Statements
Enform Plus Reference Manual—422684-001
4-19
Input Elements
•
The output-field-name can be a group name; however, Enform Plus might
not store the fields within the group in the manner you expect. To understand the
way that Enform Plus stores group elements, you must first understand what a group
is. A group is defined in DDL as any field whose level number (03, 04, and so on) is
less than that of the next field in the record. Consider, for example, the following
DDL record description:
RECORD findfl.
FILE IS $mkt.sample.findfl key-sequenced.
02 account-num.
05 type PIC 9(4).
05 num PIC BINARY 16.
02 custnum PIC 9(4).
Within this record, account-num is a group. The data type of a group is always
alphanumeric. When a group name is specified as output-field-name within a
FIND statement, Enform Plus stores each element within the group as alphanumeric
data. If one of the fields within the group is defined as binary, using a group name as
output-field-name results in an output record that might contain undesirable
data. (The undesirable results occur because the binary representation of some
numbers does not correspond to the ASCII representation of these same numbers.)
Before you execute the FIND statement, the dictionary must include a record description
that defines the structure of the input record. This record description also defines the file
type (key-sequenced, relative, entry-sequenced, or unstructured) of any data file that can
be associated with the record description. The actual file type of the data file must be the
same as the file type specified in the record description; otherwise, your query might
return incorrect results.
Input Elements
The output fields receive values from any combination of the following input elements:
•
The value of a field from the input record. The assignment to an output-field-
name is optional. When you do not specify the output-field-name, Enform
Plus operates as if it is the same as the field name from the input record. When the
output-field-name is omitted, the input field name must be fully qualified.
FIND ...
( parts.partnum,
...) ;
•
The value of a numeric literal. Remember to enclose numeric literals in parentheses.
FIND ...
(region := (5),
... );