TOPINST (Top Instruction)

The TOPINST tag defines top instructions for an application panel.

Syntax


>>-<TOPINST--+---------+-->--+------------------+--------------->
             '-COMPACT-'     '-instruction-text-'   

>--+------------+----------------------------------------------><
   '-</TOPINST>-'

Parameters

COMPACT: This attribute causes the top instruction to format without a blank line after the text.
instruction-text: This is the text of the top instruction. The instruction-text must fit in the remaining panel depth.

Comments

The TOPINST tag defines top instructions for an application panel. The instruction-text formats as a paragraph based on the width of the application panel. You can code multiple paragraphs of instruction text by using a new top instruction tag for each new paragraph.

If the COMPACT attribute is not specified, the conversion utility inserts a blank line after the top instruction text.

Restrictions

You must code the TOPINST within a PANEL definition. See PANEL (Panel) for a complete description of this tag.
You cannot code a TOPINST tag within an AREA definition. If you define an area for the panel, code the TOPINST tag before the AREA start tag.

Processing

Table 1. Tags you can code within a TOPINST definition
Tag	Reference	Usage	Required
HP	HP (Highlighted Phrase)	Multiple	No
PS	PS (Point-and-Shoot)	Multiple	No
RP	RP (Reference Phrase)	Multiple	No

Examples

Here is application panel markup that contains top instructions. Figure 1 shows the formatted result.

<!DOCTYPE DM SYSTEM>

<VARCLASS NAME=selcls TYPE='CHAR 2'>
<VARLIST>
  <VARDCL NAME=loc  VARCLASS=selcls>
  <VARDCL NAME=mode VARCLASS=selcls>
</VARLIST>

<PANEL NAME=topinst HELP=trvlhlp WIDTH=60 DEPTH=22 KEYLIST=keylxmp>
Dream Vacation Guide
<AB>
  <ABC>File
    <PDC>Add Entry
        <ACTION RUN=add>
    <PDC>Delete Entry
        <ACTION RUN=delete>
    <PDC>Update Entry
        <ACTION RUN=update>
    <PDC>Exit
        <ACTION RUN=exit>
  <ABC>Help
    <PDC>Extended Help...
        <ACTION RUN=exhelp>
    <PDC>Keys Help...
        <ACTION RUN=keyshelp>
</AB>
<TOPINST>Choose one of the following exotic locations and
your preferred mode of travel, then press Enter.
<AREA>
  <REGION DIR=horiz>
  <SELFLD NAME=loc PMTWIDTH=23 SELWIDTH=25>Exotic Location:
    <CHOICE>Athens, GA
    <CHOICE>Berlin, CT
    <CHOICE>Cairo, IL
    <CHOICE>Lizard Lick, NC
    <CHOICE>Paris, TX
    <CHOICE>Rome, NY
    <CHOICE>Venice, FL
  </SELFLD>
  <DIVIDER>
  <SELFLD NAME=mode PMTWIDTH=25 SELWIDTH=25>Travel Mode:
    <CHOICE>Boxcar
    <CHOICE>Hitchhike
    <CHOICE>Mule
  </SELFLD>
  </REGION>
</AREA>
<CMDAREA>
</PANEL>

Figure 1. Top instructions

   File  Help
 ---------------------------------------------------------
                    Dream Vacation Guide

 Choose one of the following exotic locations and your
 preferred mode of travel, then press Enter.

 Exotic Location:            Travel Mode:
 __  1.  Athens, GA          __  1.  Boxcar
     2.  Berlin, CT              2.  Hitchhike
     3.  Cairo, IL               3.  Mule
     4.  Lizard Lick, NC
     5.  Paris, TX
     6.  Rome, NY
     7.  Venice, FL




 Command ===>_______________________________________________
  F1=Help     F2=Split       F3=Exit     F6=Keyshelp
  F9=Swap    F12=Cancel