PNLINST (Panel Instruction)

The PNLINST tag defines panel instructions for an application panel.

Syntax

Parameters

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

Comments

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

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

Restrictions

You must code the PNLINST within a PANEL, AREA, or REGION definition.

Processing

Table 1. Tags you can code within a PNLINST 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 one panel instruction. 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=pnlinst 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>
<AREA>
  <PNLINST>Choose one of the following exotic locations and
  your preferred mode of travel, then press Enter.
  <DIVIDER>
  <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. Panel instructions

                    Dream Vacation Guide
 Command ===> ____________________________________________

 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