Previous Topic: 4. Subject Cross ReferenceNext Topic: 4.2 Phrase Selection


4.1 Keyword Selection


The Keyword Selection panel is displayed when you select
option 4, Subject Cross Reference, from the Document Access
primary menu.  It presents a scrollable list of key words
used in the CA MICS documentation.

You can scan for word strings or specific words using Find
and Locate commands:

o The F (Find) command narrows down the words in the list to
  those that start with the letters you type after F.  For
  example, F SMF will display all words that begin with SMF.

o The L (Locate) command moves you down the list so that the
  letters you specify after L appear at the top of the list.
  For example, L SMF will scroll you to that point in the
  keyword vocabulary where SMF occurs in alphabetical order.
  (Note that Locate operates within the range defined by the
  Find command, if it has previously been issued.)

When you select the keywords you are interested in and type
the SC primary command, you see a list of phrases from the
text that use those keywords in some combination.  From that
display you can select the phrases you want to look up in the
text.

Note: You can select two or three keywords instead of just
one, but if they are not all found together in the text, the
list of phrases will be empty.

The other way to initiate a search is to use the SC command
from any of the Document Access panels, specifying the
keywords of interest following the command. For example,

Command===> SC PRIMARY COMMAND

You would then see key phrases from the text that use the
specific word "primary" with the word "command."

Note: Uppercase/lowercase is ignored.
---------------  Subject Cross Reference - Keyword Selection  -  ROW 1 OF 4512
Command ===>                                                  Scroll ===> PAGE

Keywords ===> ________________ ===> ________________ ===> ________________

Use the SC primary command, after choosing keywords, to begin search.

Line Cmds: S Select

                       Cmd   Vocabulary        Count
                        -    ----------------  -----
                        _    ABBREVIATIONS     1
                        _    ABEND             21
                        _    ABENDS            12
                        _    ABNORMAL          9
                        _    ABORT             5
                        _    ABORTED           2
                        _    ACCEPTED          4
                        _    ACCESS            52
                        _    ACCESSES          2
                        _    ACCOUNT           127
                        _    ACCOUNTABILITY    4
                        _    ACCOUNTING        275


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

  Figure 4-1.  Subject Cross Reference Keyword Selection


THE KEYWORD FIELDS - Keywords ===>     ===>     ===>

The Keyword fields are used to enter search words that
identify the subject you wish to look up in the text.  The
words you request are matched against the keyed subject
phrases from the documentation.  Phrases containing all of
the keywords you request are then listed on the Phrase
Selection panel.  These fields are equivalent to the
arguments specified with the SC primary command.


LINE COMMANDS

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


   S (Select)

       Add the selected keyword to the next available Keyword
       field.  Equivalent to typing the selected word in the
       Keyword field.


PRIMARY COMMANDS - Command ===>

The Command field is used to enter primary commands that
control the vocabulary listing or begin the keyword searching
process.

   F (Find)

       Display all keywords in the vocabulary that match the
       find argument.

       Example:  Find a word prefix

           F JCL    (show all keywords that begin with "JCL")

       Use the R (Reset) command to return to the full
       vocabulary list.

   L (Locate)

       Scroll to the keyword named.  If the exact word is not
       in the vocabulary, the next word in the list
       (alphabetically) is located.

       Example:  Locate a keyword in the display list

           L J     (scroll to the words that begin with "J")

       Locate operates within the range defined by the F
       (Find) command, if it has previously been issued.

   LAST

       Display the previous phrase selection list, if a
       previous cross reference search has been run during
       the current session.

   M (bookMark)

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

   R (Reset)

       Remove the previous find argument selection and return
       to the full vocabulary list.  This will reposition the
       display at the beginning of the vocabulary list.

   SC (Subject Cross Reference)

       Search for phrases in the guides that contain
       specified keywords.

       Example:  Search for sections using key1 key2 key3

           SC key1 key2 key3

       Example:  Reshow last search text selection list

           SC LAST

       Example:  Search for words in the Keywords fields

           SC

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.
------------------  Subject Cross Reference - Keyword Review  -----------------
Command ===>


  Keywords : USER             :                  :


You have requested a search that will result in the retrieval of  00000506
phrases.  If this is more information than you wish to process, you may
terminate this search now and request a new search with more specific
criteria.

Press ENTER to CONTINUE search using Keywords list above
Press END to TERMINATE this search and re-specify Keywords list
 
-------------------------------------------------------------------------------
  Figure 4-2.  Subject Cross Reference Warning Panel


This warning panel is displayed, after you enter a search
request, if the list of phrases to be retrieved is very
large.  This panel is meant to prevent an expensive search
that yields too much information.

For example, words like DATA or USER appear frequently
throughout the documentation.  The number of phrases that
satisfy such an argument could be in the hundreds or
thousands.  In turn, each of these phrases might be used in
multiple sections.  Such a result is normally too massive to
be of any use, and will consume a large amount of CPU time to
produce.

Therefore, if you receive this warning, consider a more
specific request.  Try to narrow the subject by qualifying it
with another more specific keyword.