5.1 Text Selection



-------------------------  Bookmark - Text Selection  ------------  ROW 1 OF 5
Command ===>                                                  Scroll ===> PAGE

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

    Volume Name:

Line Cmds: B Browse  D Delete  P Print  S Select

Cmd Vol/File      Section            Title
 -  --------  ------------------  ---------------------------------------------
 S  PIOM      2.3.3.............  CA MICS JCL Planning and Parameters
                                  Marked from Document Browse
 _  PIOM      4.3.11............  Abend Codes and Corrective Action
                                  Marked from Document Browse
 _  PIOM      4.3.9.............  CA MICS Ddnames
                                  xref: JOB XREF
 _  TSOTSU    SYSID.............  System Identifier
                                  Marked from Element Browse
 _  PIOM      3.3.1.............  Create SAS Library for CA MICS
                                  xref: SEPARATE SAS LIBRARY
 -  --------  ------------------  ---------------------------------------------


-------------------------------------------------------------------------------
  Figure 5-1.  Bookmark Text Selection


The Bookmark Text Selection panel allows you to review the
guide sections you have marked from other text selection
panels.  The display initially shows all marked sections.

The Bookmark Text Selection panel is very similar to the
standard Document Browse Text Selection panel, except that
you can view sections from multiple guides at one time.  You
can switch to Document Browse by using the S line command on
the line of the desired section, as illustrated in Figure
5-1.  This displays the Document Browse Text Selection
panel, so you can see the contents of the selected guide at
the section level you have chosen.  This is illustrated in
Figure 5-2.

You can limit the display to a single guide by entering the
short name of the volume in the Volume ===> field. You can
also limit the display by entering chapter and section
numbers in the Section===> field.

To browse sections directly from this display, use the B
line command, as illustrated in Figure 5-3.


----------------------  Document Browse - Text Selection  ----  ROW 121 OF 359
Command ===>                                                  Scroll ===> PAGE

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

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

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

Cmd     Section            Title
 -   ------------------  ------------------------------------------------------
 _   2.3.3.............  CA MICS JCL Planning and Parameters
 _   2.3.3.1...........  JCLGEN Process Flow
 _   2.3.3.2...........  Standard JCLGEN Parameters
 _   2.3.3.3...........  JCLGEN Parameters for Special Requirements
 -   ------------------  ------------------------------------------------------


-------------------------------------------------------------------------------

  Figure 5-2.  Bookmark Entry to Document Browse

To return to the Bookmark Text Selection panel, enter the M
primary command.

-------------------------  Bookmark - Text Selection  ------------  ROW 1 OF 5
Command ===>                                                  Scroll ===> PAGE

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

    Volume Name:

Line Cmds: B Browse  D Delete  P Print  S Select

Cmd Vol/File      Section            Title
 -  --------  ------------------  ---------------------------------------------
 _  PIOM      2.3.3.............  CA MICS JCL Planning and Parameters
                                  Marked from Document Browse
 _  PIOM      4.3.11............  Abend Codes and Corrective Action
                                  Marked from Document Browse
 _  PIOM      4.3.9.............  CA MICS Ddnames
                                  xref: JOB XREF
 _  TSOTSU    SYSID.............  System Identifier
                                  Marked from Element Browse
 B  PIOM      3.3.1.............  Create SAS Library for CA MICS
                                  xref: SEPARATE SAS LIBRARY
 -  --------  ------------------  ---------------------------------------------


-------------------------------------------------------------------------------

  Figure 5-3.  Bookmark Text Selection Re-display

THE VOLUME FIELD - Volume ===>

The Volume field is used to enter a document short name, like
the name entered on the Document Browse Guide Selection
panel.  While viewing the document sections from the text
selection panel, you can subset the display to a specific
volume by entering its name in the Volume field.  To remove
the volume selection effect, blank out the Volume field and
press enter.


THE SECTION FIELD - Section ===>

The Section field is used to enter a document section number,
just as in Document Browse.  When you specify a section
number, only the sections under that number will appear in a
table of contents on the lower part of the panel.  The number
of subsection levels in the display list depends on the value
of the Levels field described below, which is normally set to
A for this type of display.

Note: From the Bookmark Text Selection panel, the S line
command is NOT equivalent to an entry in the Section field.
This command is used for browsing a text selection in
context, as discussed under the line command descriptions.


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 1 to n levels of sections under the key should display,
where n can be any number from 1 to 8.

This field is fully described under Document Browse, and is
normally set to Levels = A for subject text selection
display.  The value specified for Levels is saved in the ISPF
user profile when you exit Documentation Access and restored
upon reentry.  This enables its value to be retained across
MWF sessions.


Note:  The contents 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 resets all of
these fields.


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.

   D (Delete)

       Delete a line from the Bookmark list.

   P (Print)

       Print the text section named on the line.  This type
       of output is an immediate print of the section to
       SYSOUT=A.

   S (Select)

       Invoke the standard Document Browse dialog as if the
       volume and section selected had been entered on the
       equivalent Document Browse fields.  This command
       allows you to see the section you have selected, in
       the context of the full table of contents that it came
       from.

Multiple sections can be browsed, printed, or deleted by
entering the appropriate line command on multiple rows of
the display.  Only one line should be selected for entering
Document Browse in context.


PRIMARY COMMANDS - Command ===>

The Command field is used to enter primary commands that
control the text selection listing or the selection of
document sections to browse or print.

   B (Browse)

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

   L (Locate)

       Scroll to the guide named.  Since the list is not
       in alphabetical order, only the exact name is
       searched for.

       Example:  Locate the entries for a guide

           L MOD (scroll to the MOD guide entries)

   P (Print)

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

   R (Reset)

       Reset the display by clearing the Volume and Section
       fields and set levels back to A.

   S (Select)

       Select a Volume and optionally a Section value for the
       entry fields.  Equivalent to typing these entries into
       the fields directly.

       Example:  Limit the display to the PIOM Guide chapter
       2 (if any such entries are present)

           S PIOM 2 (display sections in this category only)

   SAVE

       Save the current Bookmark list to disk

   SORT

       Sort the current Bookmark in Volume and Section order.

   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 last search text selection list

           SC LAST

       Example:  Go to Subject Cross Reference Keyword
       Selection

           SC

Note:  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.