ENABLE Reference Manual

ENABLE ATTRIBUTES
INCLUDE Attribute
INCLUDE Attribute
The INCLUDE attribute identifies fields from a record description
that the application is to display within a box. This attribute
also specifies the order in which the fields are to appear.
Fields appear in the same order that you list them, and any field
that you do not explicitly list with this attribute is omitted
from the display. The syntax of the INCLUDE attribute is:
-----------------------------------------------------------------
| |
| INCLUDE { <qualified-field-name> } |
| { ( <qualified-field-name> [ , ... ] ) } |
| |
| <qualified-field-name> |
| |
| is the unique name of a field in the record description. |
| If you include more than one field, you must enclose the |
| field names in parentheses. When you use parentheses, |
| you can continue the INCLUDE attribute on subsequent |
| command lines. |
| |
| To avoid ambiguity, the field name must be unique within |
| the record description associated with the box. If the |
| field name is not unique, you must qualify it by |
| including the name of a unique dominant group. Refer to |
| Section 2 for information about qualifying field names. |
| If <qualified-field-name> is either the primary key, or a |
| courtesy key (Record Number field) of a record, use the |
| keyword "KEY" to include this field. |
| |
| The INCLUDE attribute has neither a starting value nor a |
| default value. If you do not supply a value for either the |
| EXCLUDE or INCLUDE attribute, all fields from a record |
| description are displayed within the box in the same order |
| that they appear in the record description. |
| |
-----------------------------------------------------------------
Considerations
When you supply a value for the INCLUDE attribute:
• If you include more than one field, the application displays
the screen label and field pairs for the fields in the order
in which you enter the field names in the SET INCLUDE command.
4-32