Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Tools : SEARCH

SEARCH
Searches the keyword or cross reference indexes to answer a query. (E)
Invocation
Do one of the following:
Usage Notes
CROSSREFSEARCH is the callable version of this tool to be used from within a rule for a cross reference search.
KEYWORDSEARCH is the callable version of this tool to be used from within a rule for a keyword search.
Before using SEARCH, you must first build the global cross reference index. To build the index for a local library from within the SEARCH tool screen, type the name of the local library in the library field and press PF5. Your system administrator must run the REFMAKER tool in batch to build an index on the installation system libraries.
In addition, before using SEARCH you must also use the KEYWORDMGR tool to build a keyword index. This tool indexes only keywords in the installation library.
Specifying Your Query String
You can enter more than one object when specifying your query string. Construct your strings using the following:
The wild card characters asterisk (*) and question mark (?) can be used if they are enclosed in single quotation marks.
Search Global Cross Reference Screen
Executing SEARCH displays the following screen:

 
Search Global Cross Reference Feb 10, 2000
Index updated: Feb 10, 2000. Library:
Find objects which refer to:
Rules ->
Tables(t,t.f,*.f)->
Screens ->
Reports ->
Global fields ->
Object sets ->
Libraries -> COMMON
Menus ->
 
Find rules which:
Raise exceptions ->
Trap exceptions(e,e t,* t)->
Declare locals ->
 
Search Keywords
Object type:
Keywords:
Names: Unit:
Operators for any query are: and, &, or, x, not, ¬.
 
 
PFKEYS: ENTER=SEARCH 12=CANCEL 3=END 4=LIST KEYWORDS 9=REPEAT

 
This section lists the parts of the Search Global Cross Reference screen and describes the fields in each part.
Global Cross Reference
 
Find objects that refer to
 
Enter the name of one or more tables. The global cross reference searches for objects that refer to these tables. A special naming convention is used for tables. Tables can be named using a table name (for example, EMPLOYEE), a table name and a field name (for example, EMPLOYEE.DEPTNO), or a wild card and a field name (for example, *.DEPTNO).
For screen tables, the search finds the screens that contain the table, as well as the objects that refer to it. For report tables, the search finds the reports that contain the table, as well as the objects that refer to it.
If only a field name is specified, the search cross references objects that refer to the field from any table.
Enter the name of one or more screens. The global cross reference searches for objects that refer to the named screens.
Enter the name of one or more reports. The global cross reference searches for objects that refer to the named reports.
Global fields
Enter the name of one or more global fields. The global cross reference searches for objects that refer to the named global fields.
Enter the name of one or more object sets. The global cross reference searches for objects that refer to the named object sets.
Enter the name of one or more libraries. The global cross reference searches for objects that refer to the named library.
Enter the name of one or more menus. The global cross reference searches for objects that refer to the named menus.
Find rules which
 
Raise exceptions
Enter the name of one or more valid exceptions. The global cross reference searches for rules that raise this exceptions.
Trap exceptions
Enter the name of one or more valid exceptions. The global cross reference searches for rules that trap it. Exceptions can be named as an exception name (for example, SYNC_ERROR), an exception name and a table (for example, GETFAIL EMPLOYEE), or a table name (for example, *EMPLOYEE). If only a table name is given, the search cross references trapped exceptions in the table.
Declare locals
Enter the name of one or more local variables. The global cross reference searches for rules that declare the variables named in the query.
Search Keywords
 
Identify the type of object being sought in a keywords, names, or unit search. You can search for one object type at a time, or for ALL. Enter one of:
Enter the name of one or more keywords that you want to search for in the keyword index. The resulting display contains objects that use the specified keywords.
Enter the units of the objects for which you want to search. Menus and windows do not have a unit attribute. Therefore they do not appear on the results of an ALL search display.
The following PF keys and function keys are recognized while the Search screen appears:
Executes the SEARCH commands.
The wild card characters asterisk (*) and question mark (?) can be used with the names or keywords being searched if they are enclosed in single quotation marks.
After running the SEARCH command, you can edit or define a displayed object by entering E (edit) or D (define) on the line command and pressing Enter.
You can create a new query by placing Q on the line command. This query is for all objects that reference the object on the line. After 1 or more Q commands, you can use PF16 to go back down the tree to the results of the previous query. After using PF16 one or more times, you can use PF14 to move up the tree again. If you use the Q command again, it changes the tree and all the results above are removed and replaced by the results of the most recent Q command.
Example
This example queries for all the objects that refer to the REFMAKER rule. The following is the result of the query:

 
RESULT OF QUERY SCROLL: P
COMMAND==>
QUERY: RULE: REFMAKER
TYPE NAME UNIT DESCRIPTION
---------------- ---------------- -------- --------------------------------
_ MENU @ADMIN
_ MENU @CRAMENU
_ RULE KEYWORDMGR3 FIND EXECUTE EACH OF THE KEYWORD UTIL
 
 
 
 
 
 
 
 
 
 
 
 
 
 
E-Edit D-Define

 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved