ENABLE Reference Manual

ENABLE FUNCTION KEYS
Multifile INSERT Operations
Multifile READ Operations
You can read a record for an outermost box by requesting any READ
operation (READ APPROX, READ EXACT, READ FIRST, READ GENERIC, or
READ NEXT) described earlier in this section.
If you want to read a record for a nested box, you must first
request either a READ or INSERT operation for its containing box.
When you READ or INSERT a record for the containing box, you
provide a join-field value that the application uses when you
read a record for the nested box. (Refer to the description of
the TREE attribute in Section 4 for the definition of a join
field.)
If you add a nested box with the FILL attribute set to ON, the
application automatically performs a READ FIRST operation on a
nested box whenever you request a READ, UPDATE, or INSERT
operation for its containing box. If the application
automatically performs a READ FIRST operation on a nested box,
you can continue reading records for that box by requesting READ
NEXT operations.
If a key field appears within a nested box, you can read records
for the nested box by entering a value in this field and
requesting any READ operation.
If a key field does not appear within a nested box, you can read
records for that box only by placing the cursor within the box
and requesting a READ FIRST or READ NEXT operation.
When you follow a READ operation on a nested box with any
operation (READ, UPDATE, DELETE, or INSERT) that changes the
join-field value of the containing box, the information in the
nested box:
• Disappears if the nested box was added with the FILL attribute
set to OFF
• Is replaced with any existing new information if the nested
box was added with the FILL attribute set to ON
Multifile INSERT Operations
When an application displays several boxes, you must request an
insert operation for the outermost box before you can request an
insert operation for any other box.
8-15