8. Examples › 8.4 Using Subject Cross Reference
8.4 Using Subject Cross Reference
------------------------- CA MICS Document Access ------------------------------
Option ===> 4
0 - User Options
Interactive and batch execution options
1 - Document Browse
Browse tables of contents and text of guides
2 - Data Element Browse
Browse Data Dictionary Elements by component and file
3 - Document Print
Print a Guide in standard format
4 - Subject Cross Reference
Locate subjects in the guides by keyword or phrase
5 - Bookmark List
Review and change the user bookmark file
T - Tutorial
How to use Document Access
X - Exit
Terminate Document Access
------------------------------------------------------------------------------
Figure 8-15. Subject Cross Reference Example
From the Document Access menu, choose option 4 to locate text
in the CA MICS guides by subject matter, across all guides.
---------------- Subject Cross Reference - Keyword Selection ROW 1 OF 4512
Command ===> L SAS 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 8-16. Cross Reference Keyword Locate Example
he Keyword Selection panel is displayed. It lists hundreds
of keywords you can choose from.
You can scroll through the list or use the Locate command to
go directly to a keyword you want to learn more about. In the
sample panel above, the user has typed L SAS to locate the
term SAS in the keyword vocabulary.
---------------- Subject Cross Reference - Keyword Selection ROW 1 OF 4512
Command ===> L SAS 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 8-17. Cross Reference Keyword Scan Example
SAS is found in the keyword vocabulary, along with a number
of more specific terms, like SASCP and SAS FLS. To select
SAS, type S in front of it and press Enter. The word SAS now
appears in the first Keyword field.
Assume you want to find documentation on SAS libraries. Since
the word SAS appears in the CA MICS documentation 322 times
(the number in the Count column), you can use the second
Keyword field to narrow the search down to SAS libraries.
You can see on the sample screen that SAS was entered in the
first Keyword field when you selected it. Now enter LIBRAR*
in the second Keyword field (to find both singular and plural
references), and type SC in the Command field to search for
phrases with both keywords.
----------------- Subject Cross Reference - Phrase Selection -- ROW 1 OF 11
Command ===> S Scroll ===> PAGE
Line Cmds: S Select
Cmd Hits Phrase
- ------ ----------------------------------------------------
_ 1 CHANGE SAS LOAD LIBRARY
_ 2 CREATE SAS LIBRARY
_ 1 SAS DATA LIBRARIES
_ 2 SAS HELP LIBRARY
_ 1 SAS LIBRARIES
_ 2 SAS LIBRARY MAINTENANCE
_ 1 SAS LOAD LIBRARY
_ 2 SAS PRODUCT LOAD LIBRARY
_ 1 SAS SUPPLEMENTAL LIBRARY
_ 3 SEPARATE SAS LIBRARY
_ 4 SPECIAL SAS LIBRARY
- ------ ----------------------------------------------------
------------------------------------------------------------------------------
Figure 8-18. Cross Reference Phrase Selection Example
The Phrase Selection panel displays 11 different combinations
of "SAS libraries" or "SAS library" in the CA MICS guides.
(There may be others, but these are the references that were
determined by the keying process to be most useful.)
At this point, you have three choices:
o You can use the F primary command to further narrow down
the display to only those phrases containing a specific
string such as the word "help."
o You can type S in front of a phrase to see the guide name
and section number where the selected phrase appears.
o You can use the S primary command to see the guide names
and section numbers where all the phrases appear. This was
done in the sample screen above.
------------------ Subject Cross Reference - Text Selection --- ROW 1 OF 15
Command ===> Scroll ===> PAGE
Volume ===> ________ Levels (n or A) ===> A
Section ===> ________________________
Volume Name:
Line Cmds: B Browse D Delete M Mark P Print S Select
Cmd Guide Section Title
- -------- ------------------ ----------------------------------------------
_ PIOM 2................. Planning for the Installation and Use of CA MICS
xref: SEPARATE SAS LIBRARY
_ PIOM 2.2............... Preparing Your Site for CA MICS
xref: SAS LIBRARY MAINTENANCE
_ PIOM 2.2.1............. List of Tasks
xref: SEPARATE SAS LIBRARY
_ PIOM 2.2.3............. SAS Library Maintenance
xref: SAS LIBRARY MAINTENANCE
B PIOM 2.3.1.6.2......... Database Complex Library Definitions
xref: SAS HELP LIBRARY
B PIOM 2.3.3.2.1.2....... Database Unit Library Definitions
xref: SAS HELP LIBRARY
_ PIOM 3.3............... Define Database Complex
xref: CREATE SAS LIBRARY
_ PIOM 3.3.1............. Create SAS Library for CA MICS
xref: SEPARATE SAS LIBRARY
_ SMG 4.3.7.5........... Altering JCL/CLIST Statements
xref: CHANGE SAS LOAD LIBRARY
------------------------------------------------------------------------------
Figure 8-19. Cross Reference Text Selection Browse Example
The titles of the text sections using the selected phrases
are then displayed, along with the first phrase that referred
to that section. In this particular case, most references
are in the PIOM guide.
The sample screen illustrates how two sections are selected
for browsing.
BROWSE -- USER01.TEMP.BROWSE1 ---------------------- LINE 000000 COL 001 080
COMMAND ===> F SAS SCROLL ===> CSR
******************************** TOP OF DATA *********************************
2.3.1.6.2 - Database Complex Library Definitions
Library definitions supply the fully-qualified data set names
and other information needed to define the procedure, SAS,
sort, and ISPF libraries associated with the database
complex.
The ISPxLIBn definitions are used to supply the data set
names of your installation's IBM ISPF and ISPF/PDF product
libraries. The FINDISPF program has been supplied to assist
you in determining the correct names to specify for these
definitions. From the TSO COMMAND PROCESSOR panel (usually
ISPF/PDF Option 6) issue the following command:
CALL 'sharedprefix.MICS.LOAD(FINDISPF)'
This command displays the exact parameters that you need to
specify for the ISPxLIBn definitions that follow:
ISPLLIB1-2:
------------------------------------------------------------------------------
Figure 8-20. Cross Reference Text Browse Example
The sample screen displays the first section selected for
browsing. It also illustrates how you can use the Find
command to find the references to SAS, rather than read the
entire section.
You can use the Repeat Find key to find the next reference to
SAS.
BROWSE -- USER01.TEMP.BROWSE1 ------------------------------ CHARS 'SAS' FOUND
COMMAND ===> SCROLL ===> CSR
SASHELP:
The name of the SAS help library.
SASLIB:
The name of the SAS Program Product load library
dedicated to hold the version of SAS used for CA MICS
database update processing. Consult the CA MICS System
Administrator Guide for information about the levels of
SAS currently supported for updating the CA MICS
database.
SASMSG:
The name of the SAS message library.
SASNAME:
------------------------------------------------------------------------------
Figure 8-21. Cross Reference Text Find Example
This sample screen illustrates the next reference to SAS,
found using the Repeat Find key.
To see the second section selected for browsing, just scroll
to the end of the first section. The second section appears
after the first section.
When you are finished reading, END returns you to the text
selection panel where you selected the sections to browse.
The next four sample screens illustrate how you can bookmark
the location of text after finding it and how you can see the
context of text after finding it.
------------------ Subject Cross Reference - Text Selection --- ROW 1 OF 15
Command ===> Scroll ===> PAGE
Volume ===> ________ Levels (n or A) ===> A
Section ===> ________________________
Volume Name:
Line Cmds: B Browse D Delete M Mark P Print S Select
Cmd Guide Section Title
- -------- ------------------ ----------------------------------------------
_ PIOM 2................. Planning for the Installation and Use of CA MICS
xref: SEPARATE SAS LIBRARY
_ PIOM 2.2............... Preparing Your Site for CA MICS
xref: SAS LIBRARY MAINTENANCE
_ PIOM 2.2.1............. List of Tasks
xref: SEPARATE SAS LIBRARY
_ PIOM 2.2.3............. SAS Library Maintenance
xref: SAS LIBRARY MAINTENANCE
_ B PIOM 2.3.1.6.2......... Database Complex Library Definitions
xref: SAS HELP LIBRARY
_ B PIOM 2.3.3.2.1.2....... Database Unit Library Definitions
xref: SAS HELP LIBRARY
_ PIOM 3.3............... Define Database Complex
xref: CREATE SAS LIBRARY
M PIOM 3.3.1............. SAS Libraries Used by CA MICS
xref: SEPARATE SAS LIBRARY
------------------------------------------------------------------------------
Figure 8-22. Cross Reference Text Mark Example
This sample screen illustrates how you can mark a section
that you want added to your bookmark list, which is
automatically saved from one session to the next.
------------------ Subject Cross Reference - Text Selection --- ROW 1 OF 15
Command ===> Scroll ===> PAGE
Volume ===> ________ Levels (n or A) ===> A
Section ===> ________________________
Volume Name:
Line Cmds: B Browse D Delete M Mark P Print S Select
Cmd Guide Section Title
- -------- ------------------ ----------------------------------------------
_ PIOM 2................. Planning for the Installation and Use of CA MICS
xref: SEPARATE SAS LIBRARY
S PIOM 2.2............... Preparing Your Site for CA MICS
xref: SAS LIBRARY MAINTENANCE
_ PIOM 2.2.1............. List of Tasks
xref: SEPARATE SAS LIBRARY
_ PIOM 2.2.3............. SAS Library Maintenance
xref: SAS LIBRARY MAINTENANCE
_ B PIOM 2.3.1.6.2......... Database Complex Library Definitions
xref: SAS HELP LIBRARY
_ B PIOM 2.3.3.2.1.2....... Database Unit Library Definitions
xref: SAS HELP LIBRARY
_ PIOM 3.3............... Define Database Complex
xref: CREATE SAS LIBRARY
_ PIOM 3.3.1............. SAS Libraries Used by CA MICS
xref: SEPARATE SAS LIBRARY
------------------------------------------------------------------------------
Figure 8-23. Cross Reference Context Browse Selection Example
This sample screen illustrates how you can use S to select a
section rather than B to browse it. Selecting a section moves
you directly into Document Browse, where you can see the
complete table of contents containing the section, to get the
context of the documentation, and perhaps then browse a
broader range of text on the topic. This is illustrated on
the next page.
Tip: To return to this Subject Cross Reference panel, use
the SC LAST primary command to get back to here from
elsewhere in Document Access.
---------------------- Document Browse - Text Selection ------ ROW 4 OF 357
Command ===> M Scroll ===> PAGE
Volume ===> PIOM Levels (n or A) ===> A
Section ===> 2.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.2............... Preparing Your Site for CA MICS
_ 2.2.1............. List of Tasks
_ 2.2.2............. Resource Planning for CA MICS
_ 2.2.3............. SAS Library Maintenance
_ 2.2.4............. Data Collector Considerations
- ------------------ ------------------------------------------------------
------------------------------------------------------------------------------
Figure 8-24. Browse in Context Example
This is the display of the section selected from Subject
Cross Reference Text Selection, now being viewed in context
under Document Browse. Now you are actually under the Browse
dialog, and can use all of the features of Document Browse,
explained in detail in Chapter 2 of this guide.
Next, assume you want to refer to the item that you marked
earlier from the Subject Cross Reference text selection
panel. To see this entry, along with other sections marked
from previous sessions, use the M primary command to see the
bookmark list.
------------------------- 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
_ PIOM 3.3.1............. Create SAS Library for CA MICS
xref: SEPARATE SAS LIBRARY
- -------- ------------------ ---------------------------------------------
------------------------------------------------------------------------------
Figure 8-25. Display Bookmark from Browse Example
This display shows five entries, 4 from a previous session,
plus the last entry, which was marked earlier from the
subject cross reference (section 3.3.1 in the PIOM Guide),
including the phrase that caused it to be located in the
first place.
From here, you can browse the text (or print it), delete the
entry, or select it and again switch to Document Browse to
see it in context.
The next set of sample panels illustrate how to use the
bookmark feature.
Copyright © 2014 CA.
All rights reserved.
|
|