The CURSOR attribute

Use the CURSOR attribute to specify the value of the NAME attribute of a CHOICE or SELFLD tag, or the value of the DATAVAR attribute of a CHOFLD, DTAFLD or LSTCOL tag. Here are the characteristics of cursor placement:

CHOFLD: The cursor appears in the first character position of the choice field. Cursor positioning is valid only when the USAGE attribute of the CHOFLD tag specifies INPUT or BOTH.
CHOICE: The cursor appears in the entry field of the specified choice in a multiple-choice selection field.
DTAFLD: The cursor appears in the first character position of the data field. Cursor positioning is valid only when the USAGE attribute of the DTAFLD tag specifies INPUT or BOTH.
LSTCOL: The cursor appears in the first row in the list column. Cursor positioning is valid only when the USAGE attribute of the LSTCOL tag specifies INPUT or BOTH.
SELFLD: The cursor appears in the entry field of the specified single-choice selection field.

Application panel fields provides a complete description of the types of interactive fields you can define for your application panels.

You can also place the cursor in the command area of the panel by specifying cmdarea as the CURSOR value.

Defining a command area provides a complete description of the CMDAREA tag.

Here is an example where the CURSOR attribute specifies the data field DATAVAR value place. When the panel is initially displayed, the cursor appears in the first character position of that field. Figure 1 shows the formatted result.

<!doctype dm system>
<panel name=mainpan1 cursor=place>Travel Agency
    <selfld name=dest selwidth=50 pmtwidth=15>Destinations:
      <choice>London
      <choice>Madrid
      <choice>Paris
      <choice>Zurich
    </selfld>
    <divider>
    <dtafld datavar=place entwidth=9 pmtwidth=5>Other
<cmdarea>
</panel>

Figure 1. Cursor placement

                               Travel Agency
 
 Destinations:
 __  1.  London
     2.  Madrid
     3.  Paris
     4.  Zurich
 
 Other _________
 
 
 
 
 
 
 
 
 
 
 
 
 Command ===> ____________________________________________________________

If no cursor placement was specified in the PANEL tag for the preceding example, the cursor would appear in the entry field of the Destinations single-choice selection field when the panel is initially displayed.