Description tab

The Description tab on the Screens tab of the AME gives you access to the information stored inside the <description> element of a macro screen. Figure 1 shows a sample Description tab:
Figure 1. Description tab
Description tab of the Macro Editor
In Figure 1, the Screens tab of the AME is selected. The name of the currently selected screen, Screen2, is displayed in the Screen Name field at the top of the Screens tab. Below the Screen Name field are the General, Description, and Actions subtabs. The Description tab is selected.

As you look at the Description tab in the figure above, you can see that it has an upper area and a lower area.

The upper area contains controls that operate on a single descriptor element considered as a whole. In particular, the Descriptor list box situated in the upper left corner of the Description tab contains the name of the currently selected descriptor. In the figure above, the currently selected descriptor is a Field Counts and OIA descriptor at the top of the list. (Descriptors do not have names. Field Counts and OIA is the type of the descriptor.)

The lower area of the Description tab displays the contents of the currently selected descriptor. Because the currently selected descriptor is a Fields Counts and OIA descriptor, the lower area of the Description tab presents the contents appropriate to that type of descriptor. If you created and selected another type of descriptor, such as a String descriptor, then the lower area would present the contents appropriate to a String descriptor.

Looking more closely at the lower area of the Description tab in Figure 1 , you can see that the Field Counts and OIA descriptor contains three tests of identity:
  • The screen contains 80 fields (the Number of Fields field is set to 80).
  • The screen contains three input fields (the Number of Input Fields field is set to 3).
  • The screen has the input inhibited indicator cleared (the Wait for OIA to Become Uninhibited list box is set to true).
The macro runtime will apply these three tests of identity when it tries to match this macro screen to an application screen.
Note: Although the AME presents the Fields Counts and OIA descriptor as a single descriptor containing three tests, in fact the macro language defines these three tests as three separate and independent descriptors. See Field Counts and OIA descriptor.

The lower area of the Description tab in Figure 1 also displays, for each of these three tests in the Field Counts and OIA descriptor, a field labeled Optional. You can ignore this field for now. The Number of Fields and Number of Input Fields descriptors also have a field labeled Inverse Descriptor. You can ignore this field for now as well. These fields are described in the section Default combining method.