2.2 Text Selection


The Text Selection Panel displays the list of chapters and
sections in the document, starting with the list of chapters.
You can control the sections displayed on this panel through
line commands and by changing the contents of the entry
fields at the top of the panel.  You can browse or print text
using the appropriate primary or line commands.

When in a section display, to return to the chapter selection
display (the table of contents), use the END command or key.
To terminate the Text Selection display, use the END command
or key again.

Figures 2-3 through 2-5 show different instances of this
panel.  Instructions on using the panels follow the figures.


----------------------  Document Browse - Text Selection  ------  ROW 1 OF 298
Command ===>

Volume  ===> PIOM                                    Levels (n or A) ===> 1
Section ===> ________________________

    Volume Name: CA MICS Planning, Install, Operation, Maintenance

Line Cmds: B Browse  M Mark  P Print  R Reset  S Select

Cmd     Section            Title
 -   ------------------  ------------------------------------------------------

 _   1.................  INTRODUCTION
 _   2.................  Planning for the Installation and Use of CA MICS
 _   3.................  INSTALLATION
 _   4.................  OPERATION
 _   5.................  MAINTENANCE
 _   A.................  SPECIAL CA MICS PROCESSING
 -   ------------------  ------------------------------------------------------

  Figure 2-3.  Document Browse Text Selection Panel (chapter level)
----------------------  Document Browse - Text Selection  ------  ROW 1 OF 298
Command ===>

Volume  ===> PIOM                                    Levels (n or A) ===> A
Section ===> ________________________

    Volume Name: CA MICS Planning, Install, Operation, Maintenance
Line Cmds: B Browse  M Mark  P Print  R Reset  S Select

Cmd     Section            Title
 -   ------------------  ------------------------------------------------------


 _   1.................  INTRODUCTION
 _   2.................  Planning for the Installation and Use of CA MICS
 _   2.1...............  Personnel Assignment and Preparation
 _   2.2...............  Preparing Your Site for CA MICS
 _   2.2.1.............  List of Tasks
 _   2.2.2.............  Resource Planning for CA MICS
 _   2.2.2.1...........  Computer Resource Requirements
 _   2.2.2.2...........  DASD Space Requirements
 _   2.2.2.3...........  Tape Usage Requirements

  Figure 2-4.  Document Browse Text Selection Panel (all levels)


----------------------  Document Browse - Text Selection  ------  ROW 1 OF 298
Command ===>

Volume  ===> PIOM                                 Levels (n or A) ===> 1
Section ===> 2

    Volume Name: CA MICS Planning, Install, Operation, Maintenance

Line Cmds: B Browse  M Mark  P Print  R Reset  S Select

Cmd     Section           Title
 -   -----------------  ------------------------------------------------------

 _   2................  Planning for the Installation and Use of CA MICS
 _   2.1..............  Personnel Assignment and Preparation
 _   2.2..............  Preparing Your Site for CA MICS
 _   2.3..............  CA MICS Installation Planning and Parameter Specification
 -   ------------------  ------------------------------------------------------

  Figure 2-5.  Document Browse Text Selection Panel (one section)
THE VOLUME FIELD - Volume ===>

The Volume field is used to enter a document short name. You
can switch to a different document by entering its name in
the Volume field.  You can return to the complete list by
blanking out the Volume field and pressing Enter.

THE SECTION FIELD - Section ===>

The Section field is used to enter a document section number.
When you specify a section number, the sections under that
number will appear in a table of contents list.  The number
of subsection levels in the list depends on the value of the
Levels field, as described below.

The S primary or line command is equivalent to an entry in
the Section field.  Whichever method you use, enter section
keys in the same form as they are listed on the display.
When you have selected the lowest level of a section, the S
command will automatically be converted to a Browse (B)
command and browse the selected section.


THE LEVELS FIELD - Levels (n or A) ===>

The Levels field allows you to specify whether all sections
beginning with the section key should display, or just the
next n levels of sections, where n can be any number from 1
to 8.

Using Levels = n, the section specified and its subordinate
sections are listed.  In other words, the value of n
determines how many levels below the current level are
displayed.  For example, if you enter section number 2 and
Levels = 1, the table of contents entries for Chapter 2 and
sections numbered 2.x are listed on the panel, as illustrated
in Figure 2-5.  Sections 2.x.x are not listed.

The same rules apply when you enter a section number with
more than one level.  For example, if you enter section 3.2
with Levels = 1, sections 3.2 and 3.2.x are listed.  Using
Levels = A, all subordinate sections, including 2.x, 2.x.x,
2.x.x.x and so on, are listed. This is illustrated in Figure
2-4.  The value specified for Levels is saved in the ISPF
user profile when you exit Documentation Access; it is
restored upon re-entry.  This enables its value to be
retained across MWF sessions.
Note:  The contents of all of these fields can be changed
directly, or you can use the S and R commands to manipulate
them automatically.  For example, the R command will reset
all of these fields.

Pressing the END key or entering the END command while in a
chapter display will return to the chapter selection display.
Pressing the END key or entering the END command again will
return to the guide selection display.


LINE COMMANDS

Line commands are entered to the left of one or more rows of
the section list.  The valid commands are:

   B (Browse)

       Browse the text section named on the line.

   M (BookMark)

       Add the text section named on the line into the
       current Bookmark List.

   P (Print)

       Print the text section named on the line.  This type
       of output is an immediate print of the section listed
       on the line, to SYSOUT=A, or to the print class
       specified on the User Options panel.

   R (Reset)

       Reset the values in the entry fields to Levels=1 and
       use the next highest section level preceding the row
       selected.  This moves the section display to the area
       of the document where the selected text belongs,
       showing all the sections at the same level as the
       selected one.

   S (Select)

       Change the section level to display.  Equivalent to
       typing the selected section number in the Section
       field.  If a figure or data element row is selected,
       the section to which it belongs is placed in the
       Section field.

Multiple sections can be browsed, printed, or marked by
entering the appropriate line command on multiple rows of the
display, but do not mix different line commands at the same
time.

Only select one line at a time.

PRIMARY COMMANDS - Command ===>

The command field is used to enter primary commands that
control the table of contents listing or the selection of
document sections to browse, print, or mark.

   B (Browse)

       Browse all the text sections listed on the display.
       This includes all sections that can be scrolled into
       the display window, not just the lines that fit on one
       screen.

   F (Find)

       Scroll to the next line in the table display that
       contains the search string in the Title field.

       After you have issued the F command with a search
       argument, you can repeat the find by issuing the F
       command without an argument.

       The range of the F command is determined by the
       subsetting already in effect on the display panel,
       starting at the line after the current line.  To
       expand the range to all lines, use the ALL option.

       Examples:

         Search for "string" starting at the next line of the
         display.  Only consider lines that meet current
         display subsetting criteria.

           F string

         Repeat the previous find.

           F
         Search for "string" starting at beginning of data,
         and consider all lines.  This option automatically
         changes the values in the entry fields to Levels=A
         and Section=blank.

           F string ALL

   L (Locate)

       Scroll to the section named.

       Example:  Locate a section in the display list

           L 2.7.3 (scroll to 2.7.3 entry)

   M (bookMark)

       Switch the display to the contents of the current
       Bookmark List.

   P (Print)

       Print all the text sections listed on the display.
       This includes all sections that can be scrolled into
       the display window, not just the lines that fit on one
       screen.

   R (Reset)

       Reset the values in the entry fields to Levels=1
       and drop the last level off the Section field.  This
       moves the section display up one level and shows all
       immediately subordinate sections.

   S (Select)

       Change the section level to display.  Equivalent to
       typing the selected section number in the Section
       field.  You can type in an entire section value or
       just add to the current Section field.  The optional
       second argument is a new value for the Levels field.
       Examples:  Select a section in the display list

           S 2.7.3 (set 2.7.3 entry in the Section field)

           S .3 2 (add .3 to the end of the Section field
                      and set levels to 2)

           S .  A (set levels to A)

   SC (Subject Cross Reference)

       Search for phrases in the guides that contain
       specified keywords, or return to previous search
       result.

       Example:  Search for sections using key1 key2 key3

           SC key1 key2 key3

       Example:  Reshow the last search text selection list

           SC LAST

       Example:  Go to Subject Cross Reference Keyword
       Selection

           SC

   SH (SHOW, AND, OR)

       Subset the table display to those lines that contain
       the search string in the Title field.

       After you have issued the SHOW command with a search
       argument, you can further define search arguments
       using the AND and OR commands.  To undo the effects of
       the SHOW command, use SH ALL to cancel SHOW.

       The range of the SHOW command is determined by the
       subsetting already in effect on the display panel. To
       expand the range to all lines, use the ALL option.
       Examples:

         Considering all lines of data, show only lines
         containing "string."  This option automatically
         changes the values in the entry fields to Levels=A
         and Section=blank.

           SH string ALL

         Perform logical AND on previous SHOW and current
         search of "string."

           AND string

         Perform logical OR on previous SHOW and current
         search of "string."

           OR string

         Within current subset range, show only lines
         containing string.

           SH string

         Turn off the SHOW command subsetting.

           SH ALL

Tip: You can browse or print the text from your most recent
text browse or print by using the keyword LAST after the B or
P primary command.

Other acceptable primary commands are the standard ISPF PF
keys and Command Table commands, like Up and Down.  If the
display list is too long to fit on one screen, these
scrolling commands allow you to move through the entire list.