Multiple panels in sequence

If no AREA tag is present or the AREA tag does not contain the DEPTH attribute, multiple help panels are generated. ISPF simulates scrolling by displaying the set of multiple help panels in sequence.

If the help panel contains additional text, the conversion utility provides an indicator at the top of the panel to notify the user. If additional text exists, the text More: is displayed followed by a + sign. Following scrolling, if additional text stills exists, the indicator displays as “More: - +”, indicating scrolling is possible in either direction. If, following scrolling, no more text is available through scrolling forward, but text is available by scrolling backward, the indicator displays as “More: -”. Scrolling function keys are defined by tutorial processing.

Here is markup that uses the previous example without a DEPTH attribute on the AREA tag to generate multiple help panels. Because all of the data does not fit in one help panel, the conversion utility created three panels: HELPSB, HELPSBX0, and HELPSBX1. The panels are displayed individually by tutorial processing. Figures Figure 1, Figure 2, and Figure 3 show the formatted results with the function key area displayed in its short form.

<!DOCTYPE DM SYSTEM>

<help name=helpsb width=46 depth=16>ShelfBrowse for Kids
<area>
  <info>
    <p>ShelfBrowse can help you
    find any kind of book you are looking for.
    The two main categories for books are:
    <dl tsize=12>
      <dthd>Book
      <ddhd>Description
      <dt>Fiction
      <dd>Fiction books are stories
      that never really happened.
      The writer made them up.
      For example:
        <ul>
          <li>Fairy Tales
          <li>Mysteries
          <li>Science fiction stories
        </ul>
      <dt>Nonfiction
      <dd>Nonfiction books are about
      things that really exist.
      For example:
        <ul>
          <li>History books
          <li>Reference books
          <li>How-to books
        </ul>
    </dl>
  </info>
</area>
</help>

Figure 1. Help panel (example 1 of 3)

 HELPSB      ShelfBrowse for Kids
                                  More:     +
 ShelfBrowse can help you find any kind of
 book you are looking for. The two main
 categories for books are:

 Book        Description

 Fiction     Fiction books are stories that
             never really happened. The
             writer made them up. For
             example:

  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel

Figure 2. Help panel (example 2 of 3)

 HELPSBX0    ShelfBrowse for Kids
                                  More:   - +
             o   Fairy Tales

             o   Mysteries

             o   Science fiction stories

 Nonfiction  Nonfiction books are about
             things that really exist. For
             example:


  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel

Figure 3. Help panel (example 3 of 3)

 HELPSBX1    ShelfBrowse for Kids
                                  More:   -
             o   History books

             o   Reference books

             o   How-to books






  F1=Help         F3=Exit         F5=Exhelp
  F6=Keyshelp     F7=PrvTopic     F8=NxtTopic
 F10=PrvPage     F11=NxtPage     F12=Cancel

You can use any of the tags provided for information regions to define the text of the information regions in your help panels.