ENABLE Reference Manual

ENABLE ATTRIBUTES
TREE Attribute
-----------------------------------------------------------------
| |
| The starting value of the TREE attribute is null. For |
| single-file applications, ENABLE uses |
| "( 01 <application-name>-BOX )" as the default value of the |
| TREE attribute, where <application-name> is the name |
| specified when you enter either an ADD APPL or a GENERATE |
| command. |
| |
-----------------------------------------------------------------
Considerations
Although you can supply a value for the TREE attribute
regardless of the contents of the object table, the boxes
identified in the structure must exist in the object table when
the application is added or generated. Refer to the ADD
command for information about adding boxes to the object table.
Single-File Applications. ENABLE can supply a default value
for the TREE attribute if you are generating a single-file
application. ENABLE uses the application name to determine a
box name. ENABLE checks to see if a box with this name exists
in the object table. If the named box is found, ENABLE uses
the box for the application. If the box is not found, ENABLE
attempts to add a box based on the current contents of the
attribute table.
Multifile Applications. Multifile applications incorporate
several associated boxes according to the hierarchical structure
specified with the TREE attribute. ENABLE uses this structure to
determine:
• The links that connect boxes to each other (Each box in
the structure must be linked to at least one other box.)
• The order of appearance and nesting of boxes on the terminal
screen (One or more fields from the first box must be included
in the display.)
• The order in which the application is to retrieve or insert
records for the boxes (An application must insert or read a
record for a parent box before it can insert or read a
record for a child box.)
4-73