home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
cset21v1.zip
/
IBMCPP
/
HELP
/
DDE4BHLP.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1993-05-19
|
102KB
|
4,068 lines
ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ
References in this help to IBM products, programs, or services do not imply
that IBM intends to make these available in all countries in which IBM
operates.
Any reference to an IBM licensed program in this help is not intended to state
or imply that only IBM's licensed program may be used. Any functionally
equivalent product, program, or service that does not infringe on any of IBM's
intellectual property rights may be used instead of the IBM product, program,
or service.
Evaluation and verification of operation in conjunction with other products,
except those expressly designated by IBM, is the user's responsibility.
IBM may have patents or pending patent applications covering subject matter in
this help. The furnishing of this help does not give you any license to these
patents.
The following terms, denoted by an asterisk (*) in this help, are trademarks of
the IBM corporation in the United States and/or other countries:
IBM
OS/2
Operating System/2
Presentation Manager
WorkFrame/2.
ΓòÉΓòÉΓòÉ 2. General Browser Concepts ΓòÉΓòÉΓòÉ
The IBM* C/C++ Tools Browser (also referred to as the C/C++ Tools browser) is a
program examining tool that helps you study program components of application
code developed in IBM* 32-bit C++.
The C/C++ Tools browser provides an environment where you can:
o Load and unload compiler-generated browser files from the Browser Control
window.
o Look at lists of program elements in your application programs in a List
window.
o View graphs that show class inheritance hierarchies, program structures, and
map function calls in a Graph window.
o View and edit source-code files in a Text window.
o Perform filtered database searches and object queries on the browser
database.
o Make objects available for query in any browser window through the browser
Object List.
ΓòÉΓòÉΓòÉ 2.1. Glossary ΓòÉΓòÉΓòÉ
Click on a term to display its definition:
access specifier
attribute filter
.BRS file
clipboard
category filter
collapsed node
filter
kind
leaf node
name
object list
occurrence
overview window
qualified name
root node
scope filter
wildcard character
zoom slider
ΓòÉΓòÉΓòÉ 2.1.1. Access Specifier ΓòÉΓòÉΓòÉ
The access specifier of an object determines the access other objects can have
to it. Access specifiers apply equally to all class member objects: member
functions, member data, nested classes, and enumerators.
The access specifiers are:
o public
o private
o protected
o friend
ΓòÉΓòÉΓòÉ 2.1.2. Attribute Filter ΓòÉΓòÉΓòÉ
An Attribute filter determines any further restrictions to the category of data
specified by the Scope and Category filters that are to be applied to a Search
Database or Query Object
ΓòÉΓòÉΓòÉ 2.1.3. Browser .BRS File ΓòÉΓòÉΓòÉ
A browser .BRS file is a file generated by the C/C++ Tools compiler. It
contains information used by the browser to examine program elements. A
browser file has the same name as the main source file of the program with a
.BRS file name extension.
You load .BRS files into the browser database using the Load option, or by
specifying their pathnames when starting the browser from the OS/2* prompt
using the ibrs command.
ΓòÉΓòÉΓòÉ 2.1.4. Clipboard ΓòÉΓòÉΓòÉ
The OS/2* clipboard is an area of memory that temporarily holds data being
passed from one program to another. The clipboard can also hold data that is
being moved or copied from one area in the Text window to another.
Data is placed on the clipboard by selecting Cut or Copy from the Text window
Edit pull-down.
Data remains in the clipboard until replaced by data from another Cut or Copy
operation.
ΓòÉΓòÉΓòÉ 2.1.5. Category Filter ΓòÉΓòÉΓòÉ
A Category filter further restricts the data specified by the Scope filter by
limiting the kind of data retrieved by a Search Database or Query Object
action.
ΓòÉΓòÉΓòÉ 2.1.6. Collapsed node ΓòÉΓòÉΓòÉ
A collapsed node is a node whose descendants are hidden (that is, not
displayed) on the graph.
ΓòÉΓòÉΓòÉ 2.1.7. Filter ΓòÉΓòÉΓòÉ
A filter is a parameter that limits a database search or object query so that
only the data that fulfills the criteria specified by the filter is retrieved.
A browser Search Database or Query Object has three filter types:
o Scope
o Category
o Attribute.
See also Filter values for searches and queries.
ΓòÉΓòÉΓòÉ 2.1.8. Kind ΓòÉΓòÉΓòÉ
The kind of an object specifies its language or system construct.
The object kinds are:
o Class
o Class Template
o Directory
o Enum
o Enumerator
o File
o Function
o Function Template
o Macro
o Typedef
o Variable
ΓòÉΓòÉΓòÉ 2.1.9. Object List ΓòÉΓòÉΓòÉ
The Object List is a list of items you copy or query from any browser window
using the Copy to Object List and Query Object actions. The Object List is
accessible from any list, graph, or text window in the browser session and
contains the last 25 objects you copied or queried.
ΓòÉΓòÉΓòÉ 2.1.10. Occurrence ΓòÉΓòÉΓòÉ
In a Text window, an occurrence is a source file or a location of an object in
a source file. An occurrence list is the result of a Search Database or Query
Object action performed from the Text window.
A database search from a Text window yields a list of all source files in the
browser database. An object query in a Text window yields a list of locations
where the queried object can be found in the currently displayed file. Each
yields a list of occurrences which can be a list of source files from the
database search, or a list of locations within one or more source files where a
query object appears.
ΓòÉΓòÉΓòÉ 2.1.11. Overview Window ΓòÉΓòÉΓòÉ
Use the Overview window to quickly scroll over the displayed graph in the Graph
window.
The Overview window contains a representation of the entire graph. A small
rectangle within the window represents the current view of the graph. Drag the
rectangle over the graph to display the part of the graph you want to view. The
Graph window shows the new position of the rectangle.
You can also size the viewing rectangle to display a smaller or larger section
of the graph.
See also Using the Overview Window.
ΓòÉΓòÉΓòÉ 2.1.12. Qualified Name ΓòÉΓòÉΓòÉ
A qualified name is the name of a list window item as it appears on the screen
when the Qualification option is active.
For example, the unqualified name of the member variable commission is:
sales_person::commission
its qualified name is:
private: double sales_person::commission
ΓòÉΓòÉΓòÉ 2.1.13. Scope Filter ΓòÉΓòÉΓòÉ
A Scope filter determines the portion of the data in the browser database to
which a Search Database or Query Object action applies.
ΓòÉΓòÉΓòÉ 2.1.14. Wildcard Character ΓòÉΓòÉΓòÉ
A wildcard character is a special character such as an asterisk (*) or a
question mark (?) that you can use to represent one or more characters.
Any single character can replace a ? wildcard character, and any set of
characters can replace a * wildcard character.
For example:
*.h identifies all items with a name that ends with the characters .h, such as
the include files stdio.h or string.h.
b?? identifies the items with three-letter names that begin with b, such as
bob, bee, and bat.
ΓòÉΓòÉΓòÉ 2.1.15. Zoom Slider ΓòÉΓòÉΓòÉ
The Zoom Slider located at the top of the Graph window allows you to quickly
zoom in or out of the displayed graph.
The zoom slider represents the range of zoom factors by which the displayed
graph can be enlarged or reduced. Move the slider arm to the right to enlarge
the displayed graph; move it to the left to reduce the graph.
The Zoom Slider is visible when the Zoom status option is active.
ΓòÉΓòÉΓòÉ 2.2. Filter Values for Searches and Queries ΓòÉΓòÉΓòÉ
You formulate database searches and object queries by specifying filters.
Available filter values depend on the window type and whether the action is a
database Search or object Query. For a list of filter values for a window type
and action, select an entry from the list below:
o List Window Filters
- Scope filters for list searches
- Category filters for list searches
- Attribute filters for list searches
- Scope filters for list queries
- Category filters for list queries
- Attribute filters for list queries
o Graph Window Filters
- Scope filters for graph searches
- Category filters for graph searches
- Attribute filters for graph searches
- Scope filters for graph queries
- Category filters for graph queries
- Attribute filters for graph queries
o Text Window Filters
- Scope filters for text searches
- Category filters for text searches
- Attribute filters for text searches
- Scope filters for text queries
- Category filters for text queries
- Attribute filters for text queries
ΓòÉΓòÉΓòÉ 2.2.1. Scope Filters for a List Search ΓòÉΓòÉΓòÉ
The following are the Scope filters for a List-window database search:
Local Scopes
Restricts the search to all objects declared in a block. Objects that are
formal arguments for a function are treated as if they were declared in the
outermost block of that function.
Class Scopes
Restricts the search to all class members.
File Scopes
Restricts the search to all objects declared outside blocks and classes.
All Globals
Restricts the search to all publicly accessible class members, all friend
functions, and all objects in file scopes (excluding static objects).
All Names
Opens the search to all objects in the current database. This is the
system default.
ΓòÉΓòÉΓòÉ 2.2.2. Category Filters for a List Search ΓòÉΓòÉΓòÉ
The following are the Category filters for a List-window database search.
Category filters further restrict the selected Scope filter.
No Filter
Opens the database search to all object Categories within the selected
Scope.
Directory
Lists all the directories that contain at least one browsable source file.
File
Lists all the source files.
Class
Lists all the classes.
Function
Lists all the functions.
Class Template
Lists all the class templates.
Function Template
Lists all the function templates. Member functions of a class template are
not included.
Variable
Lists all the variables.
Enum
Lists all the enums.
Enumerator
Lists all the enumerators.
Typedef
Lists all the typedefs.
Macro
Lists all the macros.
ΓòÉΓòÉΓòÉ 2.2.3. Attribute Filters for a List Search ΓòÉΓòÉΓòÉ
The following are the Attribute filters for a List-window database search.
Attribute filters further restrict the specified Scope and Category filters.
o Accessibility Attributes
No Filter
Lists all database objects within the selected Scope and Category.
Public
Lists only the public members within the selected Category and Scope.
Protected
Lists only the protected members within the selected Category and Scope.
Private
Lists only the private members within the selected Category and Scope.
Friend
Lists only the friend member functions within the selected Category and
Scope.
o Virtual Mode Attributes
Virtual
Lists only the virtual member functions. Pure virtual functions are not
included.
Pure Virtual
Lists only the pure virtual member functions.
All Virtual
Lists both virtual and pure virtual member functions.
Non-Virtual
Lists only the non-virtual member functions.
o Function Attributes
Ctor/Dtor
Lists only the constructors and destructors.
Operator
Lists only the operator functions.
Inline
Lists only the inline functions.
Overloaded
Lists only the overloaded functions.
Extern C
Lists only the functions that do not have C++ linkage.
o Function and Variable Attributes
Static
Lists only the function and variable objects declared with the static
keyword. File scope functions declared static inline are semantically
equivalent to inline, and are therefore not included.
Const
Lists only the objects declared with the const keyword.
Extern
Lists only the objects declared with the extern keyword.
Volatile
Lists only the volatile variables.
o Class Attributes
Roots
Lists only the classes that are not derived from a base class and have
derived classes.
Class
Lists all the classes.
Struct
Lists all the structs.
Class/Struct
Lists all the classes and the structs.
Union
Lists all the unions.
ΓòÉΓòÉΓòÉ 2.2.4. Scope Filters for a List Query ΓòÉΓòÉΓòÉ
To see a list of query Scope filters available for a specific object kind,
select a kind from the list below:
o Directory
o File
o Class
o Template
o Function
o Variable
o Enum
o Enumerator
o Typedef
o Macro
ΓòÉΓòÉΓòÉ 2.2.5. Category Filters for a List Query ΓòÉΓòÉΓòÉ
The following are the Category filters for a List-window object query.
No Filter
Lists all the objects applicable to the selected Scope and query object.
Class
Lists all the classes within the selected scope.
Function
Lists all the functions within the selected scope.
Variable
Lists all the variables within the selected scope.
Class Template
Lists all the class templates within the selected scope.
Function Template
Lists all the function templates within the selected scope.
Enum
Lists all the enums within the selected scope.
Enumerator
Lists all the enumerators within the selected scope.
Typedef
Lists all the typedefs within the selected scope.
Macro
Lists all the macros within the selected scope.
Directory
Lists all the directories within the selected scope.
File
Lists all the files within the selected scope.
ΓòÉΓòÉΓòÉ 2.2.6. Attribute Filters for a List Query ΓòÉΓòÉΓòÉ
The following are the Attribute filters for a List-window query.
o Accessibility Attributes
No Filter
Lists all database objects applicable to the selected Scope, Category
and Query object.
Public
Lists only the public members.
Protected
Lists only the protected members.
Private
Lists only the private members.
Friend
Lists only the friend member functions.
o Virtual Mode Attributes
Virtual
Lists only the virtual member functions. Pure virtual functions are not
included.
Pure Virtual
Lists only the pure virtual member functions
All Virtual
Lists both virtual and pure virtual member functions.
Non-Virtual
Lists only the non-virtual member functions.
o Function Attributes
Ctor/Dtor
Lists only the constructors and destructors.
Operator
Lists only the operator functions.
Inline
Lists only the inline functions.
Overloaded
Lists only the overloaded functions.
Extern C
Lists only the functions that do not have C++ linkage.
o Function and Variable Attributes
Static
Lists only the function and variable objects declared with the static
keyword. Because file scope functions declared static inline are
semantically equivalent to inline, they are not included.
Const
Lists only the objects declared with the const keyword.
Extern
Lists only the objects declared with the extern keyword.
Volatile
Lists only the volatile variables.
o Class Attributes
Roots
Lists only the classes that are not derived from a base class and have
derived classes.
Class
Lists all the classes.
Struct
Lists all the structs.
Class/Struct
Lists all the classes and the structs.
Union
Lists all the unions.
ΓòÉΓòÉΓòÉ 2.2.7. Scope Filters for a Graph Search ΓòÉΓòÉΓòÉ
The Scope filters for a Graph-window database search are:
Directory Tree
Displays the directory tree for all the directories and files in the
browser database, including the path to the root directory and all
intermediate subdirectories.
Inheritance
Displays the graph showing the inheritance relationships between classes in
the browser database.
Program Structure
Displays the graph showing all the directories, files, and declared objects
in the browser database.
Includes
Displays the graph showing the include relationships between the source
files in the browser database.
Calls
Displays the graph showing the calls among the functions in the browser
database.
ΓòÉΓòÉΓòÉ 2.2.8. Category Filters for a Graph Search ΓòÉΓòÉΓòÉ
The following are the Category filters for a Graph-window database search.
Expand All
Displays all the direct and indirect descendants of every node in the
graph.
Collapse All
Displays only the root nodes without showing any of their descendants.
ΓòÉΓòÉΓòÉ 2.2.9. Attribute Filters for a Graph Search ΓòÉΓòÉΓòÉ
The following are the Attribute filters available for a Graph-window database
search.
No Filter
Displays all database objects applicable to the selected Scope, Category
and Query object.
Derived Classes
Displays only the classes that are part of an inheritance relationship.
Classes that do not have an inheritance relationship are not shown.
Called Functions
Displays only the functions that are part of a calling relationship.
Functions that do not have a calling relationship are not shown.
Included Files
Displays only the files that are part of an include file relationship.
Files that do not have an include file relationship are not shown.
ΓòÉΓòÉΓòÉ 2.2.10. Scope Filters for a Graph Query ΓòÉΓòÉΓòÉ
The following are the Scope filters available for a Graph-window query when the
query object is a:
o Class
Base Classes
Displays all the base classes of the focused class.
Derived Classes
Displays all the derived classes of the focused class.
Program Structure
Displays all the members of the focused class.
o Directory
Directory Tree
Displays all the source files in the focused directory.
Program Structure
Displays all the source files in the focused directory, and all the
functions in each source file.
o File
Includes
Displays all the files that are included by the focused file.
Inclusions
Displays all the files that include the focused file.
Directory Tree
Displays all the functions in the focused file, and all the variables of
each function.
o Function
Calls
Displays all the functions that are called by the focused function.
Callers
Displays all the functions that call the focused function.
Program Structure
Displays all the variables of the focused function.
o Enum
Program Structure
Displays all the enumerators of the focused enum.
o Class Template
Program Structure
Displays all the class instantiations of the focused class template.
o Function Template
Program Structure
Displays all the function instantiations of the focused function
template.
o Enumerator, Variable, Macro, or Typedef
Program Structure
Displays a graph with a single node displaying the query object.
ΓòÉΓòÉΓòÉ 2.2.11. Category Filters for a Graph Query ΓòÉΓòÉΓòÉ
The following are the Category filters available for a Graph-window object
query.
Expand All
Displays all the direct and indirect descendants of every node in the
graph.
Collapse All
Displays only the root nodes without showing any of their descendants.
ΓòÉΓòÉΓòÉ 2.2.12. Attribute Filters for a Graph Query ΓòÉΓòÉΓòÉ
There are no Attribute filters available for a Graph-window object query.
ΓòÉΓòÉΓòÉ 2.2.13. Scope Filters for a Text Search ΓòÉΓòÉΓòÉ
The following is the Scope filter available for a Text-window database search:
All Files
Retrieves all the source code files in the browser database.
ΓòÉΓòÉΓòÉ 2.2.14. Category Filters for a Text Search ΓòÉΓòÉΓòÉ
There are no Category filters available for a Text-window database search.
ΓòÉΓòÉΓòÉ 2.2.15. Attribute Filters for a Text Search ΓòÉΓòÉΓòÉ
There are no Attribute filters available for a Text-window database search.
ΓòÉΓòÉΓòÉ 2.2.16. Scope Filters for a Text Query ΓòÉΓòÉΓòÉ
The following are the Scope filters available for a Text-window query if the
query object is not a file:
Definition
Retrieves the occurrence of each definition of the focused object. The
definition of a virtual function includes the definition and redefinition
of the function in the inheritance chain. For any other kind of object,
multiple definitions indicate a programming error.
Declaration
Retrieves the occurrence of each declaration of the focused object.
Usage
Retrieves all cross-references to the focused object.
The following are the available Scope filters if the query object is a file:
Contents
Displays the contents of the focused file
Usage
Retrieves all the cross-references (in #include statements) to the focused
file.
ΓòÉΓòÉΓòÉ 2.2.17. Category Filters for a Text Query ΓòÉΓòÉΓòÉ
There are no Category filters available for a Text-window object query.
ΓòÉΓòÉΓòÉ 2.2.18. Attribute Filters for a Text Query ΓòÉΓòÉΓòÉ
There are no Attribute filters available for a Text-window object query.
ΓòÉΓòÉΓòÉ <hidden> Directory Queries ΓòÉΓòÉΓòÉ
The following is the available List-window query Scope filter if the object
being queried is a directory:
List
Displays a list of all the subdirectories and files in the focused
directory.
ΓòÉΓòÉΓòÉ <hidden> File Queries ΓòÉΓòÉΓòÉ
The following is a list of the available List-window query Scope filters
available if the object being queried is a file:
Declarations
Displays the list of all file-scoped declarations in the focused file.
Flattened
Displays the list of all file-scoped declarations in the focused file and
the files that it directly includes.
Direct Includes
Displays the list of all files that are directly included by the focused
file.
Direct Inclusions
Displays the list of all files that directly include the focused file.
All Includes
Displays the list of all files that are directly or indirectly included by
the focused file.
All Inclusions
Displays the list of all files that directly or indirectly include the
focused file.
Includes
Prompts you for the level of direct or indirect includes for the focused
file.
Inclusions
Prompts you for the level of direct or indirect inclusions for the focused
file.
ΓòÉΓòÉΓòÉ <hidden> Class Queries ΓòÉΓòÉΓòÉ
The following is a list of the available List-window query Scope filters if the
object being queried is a class:
Declarations
Displays the list of all declarations in the focused class. This list
includes both members and friends.
Members
Displays the list of all the members of the focused class.
Flattened
Displays the flattened view of the focused class members. That is, the
members of the focused class and all of its inherited members regardless of
accessibility.
Client's View
Displays the flattened view restricted to all members that are publicly
accessible by the focused class.
Implementer's View
Displays the flattened view restricted to all members that are either public
or protected from the focused class level. This list also includes the
private members of the focused class.
Derived Class's View
Displays the flattened view restricted to all members that are either public
or protected from the focused class.
Friends
Displays the list of all friends of the focused class.
Friendships
Displays all classes that have declared the focused class as a friend.
Direct Base Classes
Displays all the direct base classes of the focused class.
Direct Derived Classes
Displays all the direct derived classes of the focused class.
All Base Classes
Displays all the direct and indirect base classes of the focused class.
All Derived Classes
Displays all the direct and indirect derived classes of the focused class.
Base Classes
Prompts you for the level of direct or indirect base classes of the focused
class.
Derived Classes
Prompts you for the level of direct or indirect derived classes of the
focused class.
Source Files
Displays the list of all files that contain the definition of the focused
class or any of its members.
Impacted Files
Displays the list of all files that will need to be recompiled if you change
the definition of the focused class in any way.
Note: The list of impacted files may be shorter than the list of files
actually recompiled with the make command because make analyzes
program components at the file level, while this query analyzes them
at the class level.
ΓòÉΓòÉΓòÉ <hidden> Template Queries ΓòÉΓòÉΓòÉ
The following is a list of available List-window query Scopes if the object
being queried is a template:
Instantiations
Displays the list of all the instantiations of the focused template.
Note: This is a list of all instantiations that can occur in the program.
The compiler may not actually create an instance in every case.
Impacted Files
Displays the list of all the files that will need to be recompiled if you
change the definition of the focused template in any way.
Note: If you change the definition of a template, all its instantiations
are impacted.
ΓòÉΓòÉΓòÉ <hidden> Function Queries ΓòÉΓòÉΓòÉ
The following is a list of the available List-window query Scope filters if the
object being queried is a function:
Direct Calls
Displays all functions that are directly called by the focused function.
Direct Callers
Displays all functions that directly call the focused function.
All Calls
Displays all functions that are directly or indirectly called by the focused
function.
All Callers
Displays all functions that directly or indirectly call the focused
function.
Calls
Prompts you for a level of direct or indirect calls.
Callers
prompts you for a level of direct or indirect callers.
Impacted Files
Displays the list of all the files that will need to be recompiled if you
change the definition of the focused function.
Note: For the browser, taking the address of a function is the same as calling
the function. The list of statically computed calls or callers
generated by this query is an approximation of the list of dynamic calls
or callers because the actual calls to a virtual function or calls
through pointers can only be determined at run time.
ΓòÉΓòÉΓòÉ <hidden> Variable Queries ΓòÉΓòÉΓòÉ
The following is a list of the available List-window query Scope filters if the
object being queried is a variable:
Usage
Displays all the functions that use or modify the focused variable.
Modifiers
Displays all the functions that directly modify the focused variable.
Indirect modifications done with pointers are not included.
Impacted Files
Displays all the files that will need to be recompiled if you change the
declaration of the focused variable.
ΓòÉΓòÉΓòÉ <hidden> Enum Queries ΓòÉΓòÉΓòÉ
The following is a list of the available List-window query Scope filters if
the object being queried is an enum:
Enumerators
Displays all the enumerators of the focused enum.
Usage
Displays all the files, functions, and classes that use the focused enum or
any of its enumerators. Usage in a class means that the enum is used in the
definition of the class.
Impacted Files
Displays all the files that will need to be recompiled if you change the
definition of the focused enum.
ΓòÉΓòÉΓòÉ <hidden> Enumerator Queries ΓòÉΓòÉΓòÉ
The following is a list of available List-window query Scope filters if the
object being queried is an enumerator:
Usage
Displays all the files, functions, and classes that use the focused
enumerator.
Impacted Files
Displays all the files that will need to be recompiled if you change the
definition of the focused enumerator.
ΓòÉΓòÉΓòÉ <hidden> Typedef Queries ΓòÉΓòÉΓòÉ
The following is a list of available List-window query Scope filters if the
object being queried is a typedef:
Usage
Displays all the files, functions and classes that use the focused typedef.
Impacted Files
Displays all the files that will need to be recompiled if you change the
definition of the focused typedef.
ΓòÉΓòÉΓòÉ <hidden> Macro Queries ΓòÉΓòÉΓòÉ
The following is a list of available List-window query Scope filters if the
object being queried is a macro:
Usage
Displays all the files, functions and classes that use the focused macro.
Impacted Files
Displays all the files that will need to be recompiled if you change the
definition of the focused macro.
ΓòÉΓòÉΓòÉ 2.3. IBRS Command ΓòÉΓòÉΓòÉ
Use the ibrs command to invoke the browser from the OS/2* prompt.
The syntax for the ibrs command is:
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöÇΓöÇIBRSΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
ΓööΓöÇΓöÇ/optionΓöÇΓöÇΓöÇΓöÿ
ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇ
ΓööΓöÇΓöÇBRS-filenameΓöÇΓöÇΓöÿ
Related Information:
o IBRS Options
o IBRS Examples
ΓòÉΓòÉΓòÉ 2.3.1. IBRS Options ΓòÉΓòÉΓòÉ
The following is a list of valid options for the IBRS command. For more
information on a particular option, select it from the list:
/Fv
/Fe
/Fm
/Fd
/X
/B
/S
/V
ΓòÉΓòÉΓòÉ 2.3.1.1. Facts-variable ΓòÉΓòÉΓòÉ
Syntax:
/Fv["all" |
"none" |
"global" |
"member+global"]
The /Fv option specifies whether global, member+global, all, or none of the
facts on variables should be included in the browser database. For large
databases, consider using member+global rather than all to reduce the size of
the database by as much as 25%.
Default is all or
/Fv["all"]
ΓòÉΓòÉΓòÉ 2.3.1.2. Facts-enumerator ΓòÉΓòÉΓòÉ
Syntax:
/Fe[+|-]
The /Fe option specifies whether all or none of the facts on the enumerators
should be included in the browser database.
Default is all or
/Fe[+]
ΓòÉΓòÉΓòÉ 2.3.1.3. Facts-macro ΓòÉΓòÉΓòÉ
Syntax:
/Fm[+|-]
The /Fm option specifies whether all or none of the facts on the macros should
be included in the browser database.
Default is all or
/Fm[+]
ΓòÉΓòÉΓòÉ 2.3.1.4. Facts-typedef ΓòÉΓòÉΓòÉ
Syntax:
/Fd[+|-]
The /Fd option specifies whether all or none of the facts on the typedefs
should be included in the browser database.
Default is all or
/Fd[+]
ΓòÉΓòÉΓòÉ 2.3.1.5. Exclude headers ΓòÉΓòÉΓòÉ
Syntax:
/Xpath[;path]
The /X option specifies the names of the header files whose program components
(or facts) you do not want loaded into the browser database. The list of file
names is kept in the database, but the facts are not. You can specify path
names using the * OS/2* wildcard.
The default is to include the facts associated with all header files in the
browser database.
ΓòÉΓòÉΓòÉ 2.3.1.6. Browser file directories ΓòÉΓòÉΓòÉ
Syntax:
/Bpath[;path]
The /B option specifies the directories in which to search for the specified
input .BRS files. The current directory is not searched unless specified.
The default is to search the current directory.
ΓòÉΓòÉΓòÉ 2.3.1.7. Source file directories ΓòÉΓòÉΓòÉ
Syntax:
/Spath[;path]
The /S option specifies the directories in which to search for source files
that are referenced in any loaded browser .BRS file if they have been moved
since the browser file was generated. The directories you specify override the
path as stored in the browser file.
The default is to search for source files in the directories they were in when
their respective browser files were generated.
ΓòÉΓòÉΓòÉ 2.3.1.8. Verbosity ΓòÉΓòÉΓòÉ
Syntax:
/V[0|1|2]
The /V option controls messages about browser file processing.
Verbosity level one (/V1) lists the name of each browser input file as it is
processed.
Verbosity level two (/V2) lists:
o The name of each browser input file as it is processed
o The number of database facts included in each file
o The time taken to load the facts into the browser database.
The default (/V[0]) is to suppress all messages about browser file processing.
ΓòÉΓòÉΓòÉ 2.3.2. Examples of the IBRS Command ΓòÉΓòÉΓòÉ
The following examples show how you use browser options while starting the
browser from the OS/2* command prompt. (myprog.brs is the name of a program
browser file:)
o Exclude facts on macros:
ibrs /Fm- myprog.brs
o Include facts only on global variables:
ibrs /Fv"global" myprog.brs
o Name two browser input files in a project directory:
ibrs /Bc:\project myprog1.brs myprog2.brs
o Specify level two verbosity:
ibrs /V2 myprog.brs
*
ΓòÉΓòÉΓòÉ 3. Browser Tasks ΓòÉΓòÉΓòÉ
Click on a browser window below for a list of applicable tasks:
o Browser Control Window Tasks
o List Window Tasks
o Graph Window Tasks
o Text Window Tasks
ΓòÉΓòÉΓòÉ 3.1. Browser Control Window Tasks ΓòÉΓòÉΓòÉ
For more information on a particular Browser Control window task, select it
from the list below:
o Loading a Browser File
o Unloading a .BRS File
o Using browser window icons
ΓòÉΓòÉΓòÉ 3.1.1. Loading a Browser File ΓòÉΓòÉΓòÉ
Use the Load Browser File window to select a browser .BRS file to load into the
browser database. This window displays automatically if you started the
browser without specifying input browser files.
To load a browser file into the browser database:
1. Click on the down arrow to the right of the Drive field to display all the
drives in your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. Type the name of the .BRS file you want to load in the Load filename entry
field or select one or more files from the File list.
5. Click on the Load push button to load your selected file.
For a detailed explanation of each field, select its name from the list below:
o Drive
o Directory
o Load filename
o File
o Type of file
ΓòÉΓòÉΓòÉ <hidden> Load filename ΓòÉΓòÉΓòÉ
Initially, this field displays a file-name expression for all the browser .BRS
files in the current directory (that is, *.brs).
Type the name of the file you want to load into the browser database in this
field, or select a file from the File list. The input file must be a valid
browser file.
Note: Wildcard characters are not accepted in this field.
ΓòÉΓòÉΓòÉ <hidden> Type of file ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Type of file field to display the
available file types. The File list displays all the files of your selected
file type in the currently selected directory.
ΓòÉΓòÉΓòÉ <hidden> Drive ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Drive field to display all the drives
in your system. The Directory displays all the directories in your selected
drive.
ΓòÉΓòÉΓòÉ <hidden> Directory ΓòÉΓòÉΓòÉ
The Directory list box displays all the directories in the drive you selected
in the Drive field. Select the directory of the browser files you want to load
from this list.
ΓòÉΓòÉΓòÉ <hidden> File ΓòÉΓòÉΓòÉ
The File list box displays all the files in the directory you selected from the
Directory list. Select one or more browser files you want to load into the
browser database from this list.
ΓòÉΓòÉΓòÉ 3.1.2. Unloading a .BRS File ΓòÉΓòÉΓòÉ
Use the Unload Browser File window to specify files to unload from the browser
database.
To unload browser files from the browser database:
1. Select one or more files from the list of loaded browser files.
2. Click on the Unload push button to unload your selected file.
ΓòÉΓòÉΓòÉ <hidden> Unload ΓòÉΓòÉΓòÉ
Click on the Unload push button to unload your selected browser file or files
from the browser database.
ΓòÉΓòÉΓòÉ 3.1.3. Icon Pop-up Menu ΓòÉΓòÉΓòÉ
You can perform other actions on browser window icons besides double-clicking
on them to restore the corresponding window. Position the mouse pointer on a
browser window icon and click on mouse button 2 to bring up the icon pop-up
menu with the following controls:
Pop-up Summary
New Opens a new browser window of the same type.
Show Restores the corresponding browser window making it active.
Maximize Enlarges the corresponding window to its largest size.
Hide Hides the corresponding window to the OS/2* desktop. Its icon
remains visible in the client area of the control window.
Close Closes the corresponding browser window.
ΓòÉΓòÉΓòÉ <hidden> New ΓòÉΓòÉΓòÉ
Use New to open a new browser window of the same type.
ΓòÉΓòÉΓòÉ <hidden> Show ΓòÉΓòÉΓòÉ
Use Show to restore a minimized browser window, or to make a restored browser
window active.
See also Maximize.
ΓòÉΓòÉΓòÉ <hidden> Hide ΓòÉΓòÉΓòÉ
Use Hide to minimize a browser window to the client area of the control window.
You can restore a minimized window using Show.
See also Maximize.
ΓòÉΓòÉΓòÉ <hidden> Maximize ΓòÉΓòÉΓòÉ
Use Maximize to enlarge a window to its largest size.
Related Information:
o Hide
o Show
ΓòÉΓòÉΓòÉ <hidden> Close ΓòÉΓòÉΓòÉ
Use Close to close the corresponding browser window.
See also Hide.
ΓòÉΓòÉΓòÉ <hidden> Browser Icon Pop-up Menu ΓòÉΓòÉΓòÉ
You can perform other actions on browser window icons besides double-clicking
on them to restore the corresponding window. Position the mouse pointer on the
Browser Windows level in a hierarchical view of the Browser Control window and
click on mouse button 2 to bring up the pop-up menu with the following
controls:
Pop-up Summary
Load Load browser files into the database.
Unload Unload browser files from the browser database.
Close browser End the browser session.
ΓòÉΓòÉΓòÉ <hidden> Close Browser ΓòÉΓòÉΓòÉ
Use Close browser to close all browser windows and end the current browser
session.
ΓòÉΓòÉΓòÉ 3.2. List Window Tasks ΓòÉΓòÉΓòÉ
For more information on a particular task, select its name from the list below:
o Selecting list items
o Saving the list in a file
o Finding a text string
o Copying an object into the object list
o Database searching
o Object querying
o Specifying query levels
ΓòÉΓòÉΓòÉ 3.2.1. Selecting list items ΓòÉΓòÉΓòÉ
To select an item in a list, position the mouse pointer over it and press mouse
button 1.
To de-select an item in the list, position the mouse pointer over the selected
item, and press mouse button 1.
ΓòÉΓòÉΓòÉ 3.2.2. Saving the List in a File ΓòÉΓòÉΓòÉ
Use the Save as window to specify the name of a file in which you want to save
the currently displayed list.
To save the displayed list in a file:
1. Click on the down arrow to the right of the Drive field to display all the
drives in your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. In the Save as filename entry field, type the name of the file in which you
want to save the displayed list, or select a file from the File list box.
5. Click on the Save push button to save the list in your specified file.
For a detailed explanation of each field, select its name from the list below:
o Drive
o Directory
o Save as filename
o File
o Save file as type
o Save
ΓòÉΓòÉΓòÉ <hidden> Save as filename ΓòÉΓòÉΓòÉ
This field is initially blank. Type the name of the file in which you want to
save the currently displayed list in this field, or select a file from the File
list box.
ΓòÉΓòÉΓòÉ <hidden> Save file as type ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Save file as type field to display the
available file types. The File list displays all the files of your selected
file type in the currently selected directory.
ΓòÉΓòÉΓòÉ <hidden> Drive ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Drive field to display all the drives
in your system. The Directory displays all the directories in your selected
drive.
ΓòÉΓòÉΓòÉ <hidden> Directory ΓòÉΓòÉΓòÉ
The Directory list box displays all the directories in the drive you selected
ΓòÉΓòÉΓòÉ <hidden> File ΓòÉΓòÉΓòÉ
The File list box displays all the files in the directory you selected from the
Directory list. Select the file in which you want to save the displayed list
from this list box.
ΓòÉΓòÉΓòÉ <hidden> Save ΓòÉΓòÉΓòÉ
Click on the Save push button to save the displayed list in your specified
file.
ΓòÉΓòÉΓòÉ 3.2.3. Finding a Text String ΓòÉΓòÉΓòÉ
Use the Find window to search for the first occurrence of a text string within
the List window contents.
You can perform a linear search from the current cursor position down to the
end of the list, or a wrap-around or circular search, from the current cursor
position down to the bottom of the list, then back from the top of the list to
the current cursor position.
To find a text string:
1. Type the search string in the Find field.
2. Select the Case Sensitive check box to perform a case sensitive search.
3. Select the Wrap-Around check box to perform a circular search.
4. Click on the Find push button to start the search.
You can jump to a group of items whose names begin with the same letter by
typing the first letter of their names. For example, to jump to the group of
items with names beginning with the letter m, type m
See also Find next.
ΓòÉΓòÉΓòÉ <hidden> Find Entry Field ΓòÉΓòÉΓòÉ
Type the text string you want to search for in the Find entry field.
The text string can consist of any literal characters, including spaces.
Note: You cannot specify the search string using wildcard characters. The
wildcard characters * and ? will be interpreted as literals if included.
Instead, widen your search by specifying a more generalized search
string.
ΓòÉΓòÉΓòÉ <hidden> Find Options ΓòÉΓòÉΓòÉ
You can specify the following options for Find:
Case Sensitive Select this check box to specify whether the search should be
case sensitive.
Wrap-Around Select this check box to perform a circular or wrap-around
search. A wrap-around search starts from the current cursor
position to the bottom of the list, and then from the top of
the list back to the current cursor position.
ΓòÉΓòÉΓòÉ <hidden> Find ΓòÉΓòÉΓòÉ
Click on the Find push button to close the Find window and begin the search
with your specified options.
ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
Click on the Cancel push button to remove the action window from the screen and
cancel the current operation without saving any changes.
ΓòÉΓòÉΓòÉ 3.2.4. Copying to the Object List ΓòÉΓòÉΓòÉ
To copy an object into the object list for query in another browser window:
1. Select an object such as a node, list item, or text fragment, from a
browser List, Graph, or Text window.
2. Select Copy to Object List from the Browse pull-down to copy your selected
object into the Object List.
Alternatively, you can double-click on a displayed object to automatically copy
the selected item into the Object List and open the Query Object window with
the selected item as the query object.
ΓòÉΓòÉΓòÉ 3.2.5. Database Searching ΓòÉΓòÉΓòÉ
Use the Search Database window to specify filters for a database search. A
database search is the first step in examining application source code using
the browser. The Search Database window is automatically displayed when you
open a window and the Object List is empty.
This option is unavailable when there are no browser files loaded into the
browser database.
To list all the objects in the database, select All Names for the Scope filter,
and No Filter for both the Category and Attribute filters. Then, click on the
Search push button to immediately start the search.
To perform a more refined database search:
1. Click on the Scope push button then select a Scope filter from the adjacent
list box.
2. To limit your search to a specific Category filter, click on the Category
push button and then select a Category filter from the list box.
3. You can further refine your query by specifying an Attribute filter. Click
on the Attribute push button and then select an Attribute filter from the
list box.
4. Click on the Search push button to start the search with your specified
search filters.
For a detailed explanation of each field, select its name from the list below:
o Scope
o Category
o Attribute
o Search
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Query Object.
ΓòÉΓòÉΓòÉ <hidden> Search ΓòÉΓòÉΓòÉ
Click on the Search push button to close the Search window and start the search
with your specified filters.
ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
Click on the Default push button to update the Scope, Category, and Attribute
filters with the default filter values.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to specify a scope for your database search.
For a list of search scopes and their meaning, see Scope filters for list
searches.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Click on the Category push button to refine your query based on an applicable
Category filter.
The Category filters available for selection depend on the Scope filter you
have selected.
For a list of the Category filters and a description of each, see Category
filters for list searches.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Click on the Attribute push button to filter your query based on the attributes
of an object.
The available attributes depend on the Scope and Category query filters you
have selected. If you select a single category for the Category filter, the
attribute list includes only the valid attributes for your selected category
(for example, Static and Const for a Variable category). If you select No
Filter for the Category filter, the attribute list includes all existing
attributes.
For a list of all the attribute filters and a description of each, see
Attribute filters for list searches.
ΓòÉΓòÉΓòÉ 3.2.6. Querying Objects ΓòÉΓòÉΓòÉ
Use the Query Object window to enter filters for an object query. This action
is unavailable when the Object List is empty or when no object is selected.
Any object that you query is added to the Object List.
To immediately start the query on your selected object based on the default
values for the Scope, Category, and Attribute query filters, click on the Query
push button.
To create a different query on the selected object:
1. Click on the Scope push button and select a query scope from the adjacent
list box. Your selection is displayed beside the Scope push button.
2. To filter your query based on the Category filters available for your
selected Scope, click on the Category push button and select a category
from the list box.
3. You can further refine your query by selecting an Attribute filter. Click
on the Attribute push button and select an attribute from the adjacent list
box.
4. Click on the Query push button to start the query.
For a detailed explanation of each field, select its name from the list below:
o Object
o Scope
o Category
o Attribute
o Query
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Search Database
ΓòÉΓòÉΓòÉ <hidden> Object ΓòÉΓòÉΓòÉ
The Objects entry field contains the name of the object being queried.
Initially, this field contains the name of the currently selected object. If no
object is currently selected, it contains the name of the object you last
queried, or the last object you copied into the Object List. To change this
value, click on the down arrow at the right of the Objects field to display the
objects in the Object List. Select an entry from this list.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to select the type of query you want to make on
a selected object. Select a scope from the adjacent list box.
The available query scopes depend on the kind of the selected object. For a
list of scopes available for each object kind, see Scope filters for list
queries.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Click on the Category push button to refine your query based on a Category
filter applicable to your selected query Scope.
The available Category filters depend on the kind of the object being queried
and the query Scope you have selected.
For a list of Category query filters and their meaning, see Category filters
for list queries.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Click on the Attribute push button to refine your query based on the attributes
of an object.
The available Attribute filters depend on the query Scope and Category filters
you have selected. For example, if you select a single category for the
Category filter, the attribute list includes only the valid attributes for your
selected category (Static and Const for a Variable category, for example). If
you select No Filter for the Category filter, the attribute list includes all
existing attributes.
For a list of query Attribute filters and their meaning, see Attribute filters
for list queries.
ΓòÉΓòÉΓòÉ <hidden> Query ΓòÉΓòÉΓòÉ
Click on the Query push button to close the Query window and start the query
with your specified query object and filters.
ΓòÉΓòÉΓòÉ 3.2.7. Specifying Query Levels ΓòÉΓòÉΓòÉ
Use the Query Levels window to set the number of levels of descendants to
include in the query when you select one of the following for the Scope filter
in a List window query:
Base Classes
Derived Classes
Callers
Calls
Includes
Inclusions
Enter a non-negative integer for the number of levels of descendants you want
to display. The query will retrieve all objects in the scope up to the level
you specify. Enter 0 to show all direct and indirect descendants.
For example, if the query object is a class, and you chose Derived Classes for
the query scope, enter level 2 to show all classes directly derived from the
focused class and all the classes derived from those classes. A level 2
displays all the derived classes of the focused class up to two levels down on
the inheritance hierarchy.
To specify a query level:
1. In the Level entry field, type the number of levels of descendants from the
focused object to include in the query.
2. Click on the OK push button to start the query with your selected query
level and filters.
ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
Click on the OK push button to start the query with your specified query level
and filters.
ΓòÉΓòÉΓòÉ 3.3. Graph Window Tasks ΓòÉΓòÉΓòÉ
For more information on a particular task, select its name from the list below:
o Selecting a node
o Finding a node
o Using the overview window
o Using the zoom slider
o Copying an object into the object list
o Searching the database
o Querying an object
ΓòÉΓòÉΓòÉ 3.3.1. Selecting a Node ΓòÉΓòÉΓòÉ
To select a node in the graph, you must highlight it. The node is then
displayed in a different color than the rest of the nodes in the graph.
To select a node, position the mouse pointer over the node and press mouse
button 1.
To de-select a node, press mouse button 1 once anywhere outside the selected
node.
ΓòÉΓòÉΓòÉ 3.3.2. Finding a Node ΓòÉΓòÉΓòÉ
Use the Find window to search for the first occurrence of a text string within
the node labels of the graph.
You can perform a linear search from the current node position down to the
bottom of the graph, or a wrap-around or circular search, from the current node
position down to the bottom of the graph, then back from the top of the graph
to the current node position.
To find a text string:
1. Type the search string in the Find field.
2. Select the Case Sensitive check box to perform a case sensitive search.
3. Select the Wrap-Around check box to perform a circular search.
4. Click on the Find push button to start the search.
See also Find next.
ΓòÉΓòÉΓòÉ 3.3.3. Using the Overview Window ΓòÉΓòÉΓòÉ
The Overview window contains a rectangle that represents the current view of
the graph. Move the overview rectangle to scroll over the graph. Size the
overview rectangle to magnify or reduce the displayed portion of the graph. You
need a mouse to move or size the overview rectangle.
To move the viewing rectangle:
1. Move the mouse pointer anywhere within the rectangle.
2. Press and hold mouse button 1 while moving the rectangle with the mouse.
3. Position the rectangle over the set of nodes you want to display.
4. Release mouse button 1.
To size the viewing rectangle:
1. Move the mouse to a border of the rectangle.
2. Press and hold mouse button 1 while dragging the border to make the
rectangle the size you want.
3. Release mouse button 1.
ΓòÉΓòÉΓòÉ 3.3.4. Using the Zoom Slider ΓòÉΓòÉΓòÉ
The Graph window features a Zoom Slider located at the top of the window. You
use it to quickly zoom in or out of the displayed graph.
The zoom slider represents the range of zoom factors by which the displayed
graph can be enlarged or reduced. Move the slider arm to the right to enlarge
the displayed graph; move it to the left to reduce the graph.
The zoom slider is visible only when the Zoom status option is active.
ΓòÉΓòÉΓòÉ 3.3.5. Database Searching ΓòÉΓòÉΓòÉ
Use the Search Database window to select filters for a database search. A
database search is the first step in examining application source code using
the browser. The Search Database window is automatically displayed when you
open a window and the Object List is empty.
This option is unavailable when there are no browser files loaded into the
browser database.
To perform a database search:
1. Click on the Scope push button and then select a Scope filter from the
adjacent list box.
2. To limit your search to a specific Category filter, click on the Category
push button then select a Category filter from the list box.
3. To further refine your query, you can specify an Attribute filter by
clicking on the Attribute push button then selecting an Attribute filter
from the list box.
4. Click on the Search push button to start the search with your specified
search filters.
For a detailed explanation of each field, select its name from the list below:
o Scope
o Category
o Attribute
o Search
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Query Object.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to specify a Scope filter.
For a list of the Scope filters and their meaning, see Scope filters for a
graph search.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Click on the Category push button to refine your query with a Category filter.
The Category filters available for selection depend on the Scope filter you
have selected. For help on the available Category filters, see Category
Filters for a graph search.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Click on the Attribute push button to filter your query based on an attribute
filter.
The attribute filters available for selection depend on the Scope and Category
query filters you have selected.
For help on Attribute filters, see Attribute filters for a graph search.
ΓòÉΓòÉΓòÉ 3.3.6. Object Querying ΓòÉΓòÉΓòÉ
Use the Query Object window to enter filters for your query. This option is
unavailable when no object is selected or when the Object List is empty.
To immediately start the query based on the default values for the Scope,
Category, and Attribute query filters, click on the Query push button.
To create a different query:
1. Click on the Scope push button and select a Scope filter from the adjacent
list box. Your selection is displayed beside the Scope push button.
2. To filter your query based on an available Category filter, click on the
Category push button and select a Category filter from the list box.
3. To further refine your query with an Attribute filter, click on the
Attribute push button and select an Attribute filter from the adjacent list
box.
4. Click on the Query push button to start the query.
For a detailed explanation of each field, select its name from the list below.
o Object
o Scope
o Category
o Attribute
o Query
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Database Search.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to select the scope of the query you want to
make on your selected item. Select a Scope filter from the adjacent list box.
The available Scope filters depend on the kind of the selected object. For a
list of scopes available for each query object kind, see Scope filters for a
graph query.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Click on the Category push button to refine your query based on a Category
filter applicable to your selected query Object and Scope.
The available Category filters depend on the kind of the object being queried
and the query Scope you have selected. For a list of Category filters, see
Category filters for a graph query.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Click on the Attribute push button to refine your query based on an Attribute
filter.
The available Attribute filters depend on the query object kind and the Scope
and Category filters you have selected. For a list of possible attribute
filters, see Attribute filters for a graph query
ΓòÉΓòÉΓòÉ 3.4. Text Window Tasks ΓòÉΓòÉΓòÉ
For more information on a particular task, select it from the list below:
o Selecting text
o Finding text
o Saving edited source files
o Finding and replacing text
o List occurrences
o Copying an object into the object list
o Searching the database
o Querying an object
ΓòÉΓòÉΓòÉ 3.4.1. Selecting Text ΓòÉΓòÉΓòÉ
To select text from the Text window:
1. Move the mouse pointer to the left of the first character to be selected.
2. Press and hold mouse button 1, then drag the cursor to the right of the
last character to be selected.
3. Release mouse button 1.
To de-select text, press mouse button 1 once anywhere outside the selected
text.
ΓòÉΓòÉΓòÉ 3.4.2. Finding Text ΓòÉΓòÉΓòÉ
Use the Find window to search for the first occurrence of a text string within
the displayed text.
You can perform a linear search from the current cursor position down to the
end of the displayed file, or a wrap-around or circular search, from the
current cursor position down to the end of the file, then back from the top of
the file to the current cursor position.
To find a text string:
1. Type the search string in the Find field.
2. Select the Case Sensitive check box to perform a case sensitive search.
3. Select the Wrap-Around check box to perform a circular search.
4. Click on the Find push button to start the search.
See also Find next.
ΓòÉΓòÉΓòÉ 3.4.3. Saving Edited Source Files ΓòÉΓòÉΓòÉ
Use the Save as window to save a file and assign it a name.
To save a file:
1. Click on the down arrow to the right of the Drive field to display all the
drives in your system.
2. Select drive from the Drive list.
3. Select a directory from the Directory list box.
4. In the Save as filename entry field, type the name of a file or select a
file from the File list box.
5. Click on the Save push button to save the displayed source file in your
specified file.
For a detailed explanation of each field, select its name from the list below:
o Drive
o Directory
o Save as filename
o Save file as type
o File
o Save
o Cancel
ΓòÉΓòÉΓòÉ <hidden> Save as filename ΓòÉΓòÉΓòÉ
This field initially contains the name of the currently displayed source file.
Type the name of a file in which you want to save the currently displayed
source text in this field, or select a file from the File list box.
ΓòÉΓòÉΓòÉ <hidden> Save file as type ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Save file as type field to display the
available file types. The File list box displays all the files of your
selected file type in the currently selected directory.
ΓòÉΓòÉΓòÉ <hidden> Drive ΓòÉΓòÉΓòÉ
Click the down arrow to the right of the Drive field to display all the drives
in your system. The Directory displays all the directories in your selected
drive.
ΓòÉΓòÉΓòÉ <hidden> Directory ΓòÉΓòÉΓòÉ
The Directory list box displays all the directories in the drive you selected
in the Drive field.
ΓòÉΓòÉΓòÉ <hidden> File ΓòÉΓòÉΓòÉ
The File list box displays all the files in the directory you selected from the
Directory list. Select the file in which you want to save the displayed text
from this list box.
ΓòÉΓòÉΓòÉ <hidden> Save ΓòÉΓòÉΓòÉ
Click on the Save push button to save the displayed text your specified file.
ΓòÉΓòÉΓòÉ 3.4.4. Replacing Text ΓòÉΓòÉΓòÉ
Use the Replace window to enter a text string to find and replace within the
displayed text.
To find and replace a text string:
1. Type the text string you want to replace in the Find entry field.
2. In the Replace entry field, type the text string you want to replace the
Find text string with.
3. Select the Case Sensitive check box if the find action is to be case
sensitive.
4. Select the Replace All check box if you want all instances of the text
string in the Find field replaced by the text string in the Replace replace
field at once without prompting.
5. Select the Wrap Around check box if you want the find and replace action to
start from the current cursor position down to the end of the source file,
then back up from the beginning of the source file to the current cursor
position.
6. Click on the Replace push button to start the Replace action with your
specified options.
ΓòÉΓòÉΓòÉ <hidden> Find ΓòÉΓòÉΓòÉ
Type the text string you want to replace in the Find entry field.
The text string can consist of any literal characters. Do not use wildcard
characters. They will be interpreted as literals in the Replace action.
ΓòÉΓòÉΓòÉ <hidden> Replace ΓòÉΓòÉΓòÉ
In the Replace entry field, type the text string to replace the text string
that is in the Find field.
The text string can consist of any literal characters. Do not use wildcard
characters. They will be interpreted as literals in the Replace action.
ΓòÉΓòÉΓòÉ <hidden> Replace Options ΓòÉΓòÉΓòÉ
The Replace action has three options:
o Select the Case Sensitive check box if you want the find action to be case
sensitive.
o Select the Replace All check box if you want all instances of the text string
in the Find field replaced by the text string in the Replace field at once
without prompting.
o Select the Wrap Around check box if you want the find and replace action to
start from the current cursor position down to the end of the source file,
then back up from the beginning of the source file to the current cursor
position.
ΓòÉΓòÉΓòÉ <hidden> Replace ΓòÉΓòÉΓòÉ
Click on the Replace push button to start the Replace action with your
specified options.
ΓòÉΓòÉΓòÉ 3.4.5. Listing Occurrences ΓòÉΓòÉΓòÉ
Use the Occurrences list window to select an occurrence to display in the Text
window. The list of occurrences is the result of your last Search Database or
Query Object action from the Text window.
To display an occurrence from the occurrences list:
1. Select an occurrence from the list box.
2. Click on the Display push button to display your selected occurrence.
Related Information:
o Next
o Previous
ΓòÉΓòÉΓòÉ <hidden> Display ΓòÉΓòÉΓòÉ
Click on the Display push button to display your selected source file.
ΓòÉΓòÉΓòÉ 3.4.6. Database Searching ΓòÉΓòÉΓòÉ
Use the Search Database window to select filters for a database search. A
database search is the first step in examining application source code using
the browser. The Search Database window is automatically displayed when you
open a window and the Object List is empty.
This option is unavailable when there are no browser files loaded in the
browser database.
To perform a database search:
1. Click on the Scope push button.
2. Select a search scope from the adjacent list box.
3. To limit your search to a specific Category filter, click on the Category
push button then select a Category filter from the list box.
4. To further refine your query, you can specify an Attribute filter by
clicking on the Attribute push button. Select an Attribute filter from the
list box.
5. Click on the Search push button to start the search with your specified
search filters.
For a detailed explanation of each field, select its name from the list below:
o Scope
o Category
o Attribute
o Search
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Object Query.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to specify a search scope. The available Scope
filter for a Text window search is:
All Files
Displays all the source code files in the browser database.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Use the Category push button to refine your query with a Category filter.
The Category filters available for selection depend on the Scope filter you
have selected. For help on the possible Category filters, see Category filters
for a text search.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Use the Attribute push button to filter your query based on an attribute
filter.
The attribute filters available for selection depend on the Scope and Category
query filters you have selected.
For help on Attribute filters, see Attribute filters for a text search.
ΓòÉΓòÉΓòÉ 3.4.7. Querying Objects ΓòÉΓòÉΓòÉ
Use the Query Object window to enter filters for your object query.
To query a specific text string object, select it from the Text window then
select Query Object from the Browse pull-down. Alternatively, you can
double-click on the selected object to bring up the Query Object window with
your selected item as the query object. The query object is copied into the
Object List either way.
To immediately start the query based on the default values for the Scope,
Category, and Attribute query filters, click on the Query push button.
To create a different query:
1. Click on the Scope push button and then select a Scope filter from the
adjacent list box. Your selection is displayed beside the Scope push
button.
2. To filter your query based on an available Category filter, click on the
Category push button and then select a Category filter from the list box.
3. To further refine your query with an Attribute filter, click on the
Attribute push button then select an attribute from the adjacent list box.
4. Click on the Query push button to start the query.
For a detailed explanation of each field, select its name from the list below:
o Object
o Scope
o Category
o Attribute
o Query
o Default
o Cancel
Hint: You can double-click on a filter in the list box to select it and bring
up the next set of filters. For example, you can double-click on a Scope
filter to select it and bring up the list of Category filters.
See also Database Search.
ΓòÉΓòÉΓòÉ <hidden> Scope ΓòÉΓòÉΓòÉ
Click on the Scope push button to select the type of query you want to make on
a selected item. Select a scope from the adjacent list box.
The available query scopes depend on the kind of the selected object. For a
list of scopes available for each object kind, see Scope filters for a text
query.
ΓòÉΓòÉΓòÉ <hidden> Category ΓòÉΓòÉΓòÉ
Click on the Category push button to refine your query based on a Category
filter applicable for your selected query Object and Scope.
The Category filters available for selection depend on the kind of the object
being queried and the query Scope you have selected. For a list of Category
filters, see Category filters for text queries.
ΓòÉΓòÉΓòÉ <hidden> Attribute ΓòÉΓòÉΓòÉ
Click on the Attribute push button to refine your query based on an Attribute
filter.
The Attribute filters available for selection depend on the kind of the query
object and the Scope and Category filters you have selected. For a list of
possible attribute filters, see Attribute filters for text queries
ΓòÉΓòÉΓòÉ 4. Browser Control Window ΓòÉΓòÉΓòÉ
The browser Control window is the starting point for examining program
components using the browser. The Control window is displayed during the
entire browser session. Tasks that apply to the entire browser session, such
as browser file loading and unloading, and opening new browser windows, are
performed in this window.
The client area of the Browser Control window displays browser window icons
that remain visible as long as their corresponding windows are open. You can
make any existing browser window active by double-clicking on its corresponding
icon or name.
Related Information:
o List window
o Graph window
o Text window
ΓòÉΓòÉΓòÉ 4.1. Database ΓòÉΓòÉΓòÉ
Select Database on the menu bar to load or unload browser .BRS files for the
current browser session, and to open new browser windows.
Pull-down Summary
Open Opens new List, Graph and Text windows.
Load Loads browser files into the current browser session.
Unload Unloads browser files from the current browser session.
Close Browser Closes all browser window and ends the browser session.
ΓòÉΓòÉΓòÉ 4.1.1. Open ΓòÉΓòÉΓòÉ
Use the Open cascaded menu to open a new List, Graph, or Text window.
You can open multiple browser windows within a single browser session.
ΓòÉΓòÉΓòÉ 4.1.1.1. List ΓòÉΓòÉΓòÉ
Use List to open a new List window.
ΓòÉΓòÉΓòÉ 4.1.1.2. Graph ΓòÉΓòÉΓòÉ
Use Graph to open a new Graph window.
ΓòÉΓòÉΓòÉ 4.1.1.3. Text ΓòÉΓòÉΓòÉ
Use Text to open a new Text window.
ΓòÉΓòÉΓòÉ 4.1.2. Load ΓòÉΓòÉΓòÉ
Use Load to add a browser .BRS file to the current browser session. You are
prompted with the Load Browser File window where you can select files to load
into the browser database.
Another method of loading a browser file is to enter its name when you issue
the ibrs command to start the browser from the OS/2* prompt.
See also Unload.
ΓòÉΓòÉΓòÉ 4.1.3. Unload ΓòÉΓòÉΓòÉ
Use Unload to remove browser .BRS files from the current browser session. You
are prompted with the Unload Browser File window where you can select files to
unload from the browser database.
See also Load.
ΓòÉΓòÉΓòÉ 4.2. View ΓòÉΓòÉΓòÉ
Select View on the menu bar to change the display settings of the browser
Browser Control window.
Pull-down Summary
Layout Controls the layout style of browser window icons.
Style Specifies the icon and placement style of the browser window icons.
ΓòÉΓòÉΓòÉ 4.2.1. Layout ΓòÉΓòÉΓòÉ
Use Layout to control browser window icon style and the placement of browser
window icons in the control window.
Menu Summary
Horizontal Arranges the icons horizontally within the Browser Control
window.
Vertical Arranges the icons vertically within the Browser Control window.
Hierarchical Arranges the icons in a hierarchical fashion within the Browser
Control window.
ΓòÉΓòÉΓòÉ 4.2.1.1. Horizontal ΓòÉΓòÉΓòÉ
Select Horizontal if you want to arrange the icons horizontally in rows across
the screen. This is the system default.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ 4.2.1.2. Vertical ΓòÉΓòÉΓòÉ
Select Vertical if you want to arrange the icons vertically in columns within
the control window. A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ 4.2.1.3. Hierarchical ΓòÉΓòÉΓòÉ
Select Hierarchical if you want to arrange the icons in a hierarchical format
within the Browser Control window. A check mark appears next to your
selection.
ΓòÉΓòÉΓòÉ 4.2.2. Style ΓòÉΓòÉΓòÉ
Use Style to specify the layout style of the browser window icons in the
Browser Control window.
Menu Summary
Invisible Displays the names of each browser window object without a
corresponding icon.
Flowed Controls the way icons are placed in the Browser Control window.
Lines Specifies whether lines are drawn between icons in a Hierarchical
layout.
ΓòÉΓòÉΓòÉ 4.2.2.1. Invisible ΓòÉΓòÉΓòÉ
Select Invisible if you do not want icons to be displayed in the control
window. The name of each open browser window is displayed in the control
window without a corresponding icon.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ 4.2.2.2. Flowed ΓòÉΓòÉΓòÉ
Select Flowed if you want the icons automatically re-arranged in columns across
the screen when you resize the control window. If you do not select Flowed, the
icons remain in their original position when you resize the control window.
A check mark appears next to your selection.
Flowed is only available for a Vertical icon layout.
ΓòÉΓòÉΓòÉ 4.2.2.3. Lines ΓòÉΓòÉΓòÉ
Select Lines if you want lines drawn between icons in a Hierarchical layout.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ 5. List window ΓòÉΓòÉΓòÉ
Use the List window to generate a list of program elements, such as files,
functions, and classes, from the browser database. You can specify filtering
options in a Search Database or Query Object action so that the list only
includes the specific program elements you want to examine.
Related Information:
o Browser Control window
o Graph window
o Text window
ΓòÉΓòÉΓòÉ 5.1. List ΓòÉΓòÉΓòÉ
Select List from the menu bar to save the displayed list in a file, make the
Browser Control window active, or exit the browser.
Pull-down Summary
Save as
Outputs the contents of the List window into a file.
Browser Control
Moves the Browser Control window to the front of the screen and makes
it active.
Close Browser
Ends the browser session.
ΓòÉΓòÉΓòÉ 5.1.1. Save as ΓòÉΓòÉΓòÉ
Use Save as to store the contents of the List window in a file.
You are prompted for the name of a file in which to store the contents of the
List window as ASCII output.
ΓòÉΓòÉΓòÉ 5.1.2. Browser Control ΓòÉΓòÉΓòÉ
Select Browser Control to move the control window to the front of the screen
and make it active.
ΓòÉΓòÉΓòÉ 5.1.3. Close Browser ΓòÉΓòÉΓòÉ
Use Close Browser to close all open browser windows and end the browser
session.
ΓòÉΓòÉΓòÉ 5.2. Browse ΓòÉΓòÉΓòÉ
Select Browse from the menu bar to add objects into the Object List, or perform
a database search or object query.
Pull-down Summary
Search Database
Perform a search of the browser database.
Query Object
Query the selected object or an object in the Object List.
Copy to Object List
Copy the selected object into the Object List.
ΓòÉΓòÉΓòÉ 5.2.1. Search Database ΓòÉΓòÉΓòÉ
Use Search Database to perform a database search when the window is empty or
when a query on a specific object is not required. You can specify filters for
your search in the Search Database window.
Performing a database search is the first step in examining program source code
using the browser.
See also Query Object.
ΓòÉΓòÉΓòÉ 5.2.2. Query Object ΓòÉΓòÉΓòÉ
Use Query Object to perform a query on the selected object or an object in the
Object List. All queried objects are copied into the Object List.
Related Information:
o Search Database
o Copy to Object List
ΓòÉΓòÉΓòÉ 5.2.3. Copy to Object List ΓòÉΓòÉΓòÉ
Use Copy to Object List to copy a displayed object into the browser Object
List.
To copy an object into the Object List:
1. Select an object such as a node, list item, or text fragment, from a
browser List, Graph, or Text window.
2. Select Copy to Object List from the Browse pull-down to copy your selected
object into the Object List.
Alternatively, you can double-click on a displayed object to automatically copy
the selected item into the Object List and open the Query Object window with
the selected item as the query object. Invoking the Query Object action while
an object is selected will also copy the selected object into the Object List
and bring up the Query Object window.
ΓòÉΓòÉΓòÉ 5.3. Edit ΓòÉΓòÉΓòÉ
Select Edit from the menu bar to search for text in the List window.
Pull-down Summary
Find Locates the first occurrence of a text string within the list
items.
Find next Repeats the action specified by the most recent Find operation.
ΓòÉΓòÉΓòÉ 5.3.1. Find ΓòÉΓòÉΓòÉ
Use Find to locate a text string within the List window starting from the
current cursor position.
This option is unavailable when the List window is empty.
See also Find next.
ΓòÉΓòÉΓòÉ 5.3.2. Find next ΓòÉΓòÉΓòÉ
Use Find next to find the next occurrence of the text string specified in the
most recent Find operation.
The options that were active in the last Find operation remain active for any
subsequent Find next operations. The Find next action is always performed from
the current cursor position.
This option is unavailable when the window is empty or when a Find operation
has not yet been performed.
ΓòÉΓòÉΓòÉ 5.4. View ΓòÉΓòÉΓòÉ
Select View from the menu bar to display or hide information about list
elements, and sort the displayed list.
Pull-down Summary
Qualification Displays the access specifier and type for each element in the
list.
Kind Displays the kind of each item in the List window.
Sort Sorts the list items by their names in ascending or descending
order.
Status Displays the size of the displayed list and the filters of your
last database Search or object Query.
Reset Clears the contents of the List window.
For more information on a View pull-down option, select it from the list above.
ΓòÉΓòÉΓòÉ 5.4.1. Qualification ΓòÉΓòÉΓòÉ
Select Qualification to display the access specifier and type for each element
in the list. A check mark appears next to your selection.
Class members are always qualified by the name of their class; functions are
qualified by their arguments and return type.
See also Kind.
ΓòÉΓòÉΓòÉ 5.4.2. Kind ΓòÉΓòÉΓòÉ
Select Kind to display the object kind of each item displayed in the List
window. A check mark appears next to your selection.
The object kind is displayed at the end of each object name preceded by a dash
(-).
See also Qualification.
ΓòÉΓòÉΓòÉ 5.4.3. Sort ΓòÉΓòÉΓòÉ
Use Sort to arrange the list items in alphabetical sequence by their names. If
the Qualification option is active, the list items are sorted by their fully
qualified names; otherwise, they are sorted by their unqualified names.
The sort options are:
Ascending Orders the list items from the lowest alphabetical value to the
highest, that is, from A to Z.
Descending Orders the list items from the highest alphabetical value to the
lowest, that is, from Z to A.
This option is unavailable when the List window is empty.
ΓòÉΓòÉΓòÉ <hidden> Ascending sort ΓòÉΓòÉΓòÉ
Select Ascending to order the list items by their qualified or unqualified
names from the lowest alphabetical value to the highest, that is, from A to Z.
List items are sorted by their qualified names if the Qualification option is
active.
See also Descending sort.
ΓòÉΓòÉΓòÉ <hidden> Descending sort ΓòÉΓòÉΓòÉ
Select Descending to order the list items by their qualified or unqualified
names from the highest alphabetical value to the lowest, that is, from Z to A.
List items are sorted by their qualified names if the Qualification option is
active.
See also Ascending sort.
ΓòÉΓòÉΓòÉ 5.4.4. Status ΓòÉΓòÉΓòÉ
Select Status to display the size of the displayed list, and the parameters of
your last Search Database or Query Object action on scrollable status lines
near the top of the List window.
Menu Summary
Object Displays the object of your last object query on the Object status
line.
Query Displays the filters of your last database search or object query on
the Query status line.
Size Displays the number of items in the displayed list on the Size status
line.
All Displays all the List window status lines.
None Hides all the List window status lines.
ΓòÉΓòÉΓòÉ <hidden> Object ΓòÉΓòÉΓòÉ
Select Object status to display the object of your last Query Object action on
the Query status line near the top of the List window.
ΓòÉΓòÉΓòÉ <hidden> Query ΓòÉΓòÉΓòÉ
Select Query status to display the filters of your last Search Database or
Query Object action on the Query status line near the top of the List window.
ΓòÉΓòÉΓòÉ <hidden> Size ΓòÉΓòÉΓòÉ
Select Size status to display the number of items in the displayed list on the
Size status line near the top of the List window.
ΓòÉΓòÉΓòÉ <hidden> All ΓòÉΓòÉΓòÉ
Select All status to display all the List window status lines.
ΓòÉΓòÉΓòÉ <hidden> None ΓòÉΓòÉΓòÉ
Select None to remove all the visible List window status lines.
ΓòÉΓòÉΓòÉ 5.4.5. Reset ΓòÉΓòÉΓòÉ
Select Reset to clear the contents of the List window. It then behaves like a
newly opened window.
ΓòÉΓòÉΓòÉ 6. Graph Window ΓòÉΓòÉΓòÉ
Use the Graph window to view graphically described relationships between
program components. Objects are displayed as nodes and relationships between
objects are shown as arcs or lines connecting the nodes. Private relationships
are shown using a different colored line or line style. Virtual base class
relationships use dotted lines.
Class inheritance hierarchies and program structures are two kinds of graphs
you can view using this window.
Related Information:
o Browser Control window
o List window
o Text window
ΓòÉΓòÉΓòÉ 6.1. Graph ΓòÉΓòÉΓòÉ
Select Graph from the menu bar to make the Browser Control window active and
exit the browser.
Pull-down Summary
Browser Control
Moves the Browser Control window to the front of the screen and makes
it active.
Close Browser
Closes all browser windows and exits the browser.
ΓòÉΓòÉΓòÉ 6.2. Browse ΓòÉΓòÉΓòÉ
Select Browse from the menu bar to add objects into the Object List, or perform
a database search or object query.
Pull-down Summary
Search Database
Perform a search of the browser database.
Query Object
Query a selected object or an object from the Object List.
Copy to Object List
Copy the selected object into the Object List.
ΓòÉΓòÉΓòÉ 6.2.1. Search Database ΓòÉΓòÉΓòÉ
Use Search Database to perform a database search when the Object List is empty
or when a query on a specific element is not required. Performing a database
search is the first step in examining program source code using the browser.
See also Query Object.
ΓòÉΓòÉΓòÉ 6.2.2. Query Object ΓòÉΓòÉΓòÉ
Use Query Object to query a selected object or an object in the Object List.
To query a displayed object, select it then select Query Object from the Browse
pull-down. Alternatively, you can double-click on the displayed object to
bring up the Query Object window with the selected item as the query object.
Any query action will copy the query object into the Object List.
This action is unavailable when the Object List is empty and when no object is
selected.
See also Search Database.
ΓòÉΓòÉΓòÉ 6.2.3. Copy to Object List ΓòÉΓòÉΓòÉ
Select Copy to Object List to copy a selected object into the browser Object
List.
To copy an object into the Object List:
1. Select an object such as a node, list item, or text fragment, from a
browser List, Graph, or Text window.
2. Select Copy to Object List from the Browse pull-down to copy your selected
object into the Object List.
Alternatively, you can double-click on a displayed object to automatically copy
the selected item into the Object List and open the Query Object window box
with the selected item as the query object.
ΓòÉΓòÉΓòÉ 6.3. Edit ΓòÉΓòÉΓòÉ
Use Edit to find a node in the graph.
Pull-down Summary
Find Finds a node in the graph.
Find next Repeats the last action specified by the most recent Find
operation from the current cursor position.
ΓòÉΓòÉΓòÉ 6.3.1. Find ΓòÉΓòÉΓòÉ
Use Find to locate a text string within the node labels of the displayed graph.
This option is unavailable when the Graph window is empty.
See also Find next.
ΓòÉΓòÉΓòÉ 6.3.2. Find next ΓòÉΓòÉΓòÉ
Use Find next to find the next occurrence of the text string specified in the
most recent Find operation.
The options that were active in the last Find operation remain active for any
subsequent Find next operations. The Find next action is always performed from
the current cursor position.
This option is unavailable when the Graph window is empty or when a Find
operation has not yet been performed.
ΓòÉΓòÉΓòÉ 6.4. View ΓòÉΓòÉΓòÉ
Select View from the menu bar to change the appearance of the graph and show
status information about the displayed graph.
Pull-down Summary
Overview Opens a small window containing a representation of the entire
graph that you can use to scroll over the graph displayed in
the Graph window.
Node Expands, collapses, or centers nodes on the graph.
Magnify Enlarges or reduces a selected area of the displayed graph.
Zoom Enlarges or reduces the displayed graph while keeping the
current perspective.
Collapsed Arcs Displays the arcs leading to hidden descendants of collapsed
nodes.
Layout Draws the graph in a horizontal or vertical layout.
Level Determines the arrangement of nodes in the graph.
Quality Controls the speed and quality of the graph display.
Style Draws the graph nodes in a 2-dimensional or 3-dimensional node
style.
Status Displays the filters of your last database Search or object
Query.
Relay Redraws the graph, setting the zoom factor back to zero and
recentering the graph.
Reset Clears the contents of the Graph window.
ΓòÉΓòÉΓòÉ 6.4.1. Overview ΓòÉΓòÉΓòÉ
Use Overview to open a small window containing a representation of the entire
graph. A smaller rectangle within the window represents the current view of
the graph. You can drag the rectangle to scroll over the graph so you can
display a part of the graph or the entire graph at one time. As you drag the
rectangle, the visible portion of the graph in the Graph window is updated to
correspond with the new position of the rectangle.
You can also size the viewing rectangle to display a smaller or larger section
of the graph as you wish. See Using the Overview Window.
ΓòÉΓòÉΓòÉ 6.4.2. Node ΓòÉΓòÉΓòÉ
Use Node to expand or collapse nodes on the graph.
Pull-down Summary
Expand
Displays all the direct descendants of the currently selected node.
Expand All
Displays all the direct and indirect descendants of the currently selected
node.
Collapse All
Hides all the descendants of the selected node, including those pointed to
by other visible nodes.
Center
Centers the selected node on the graph.
See also Selecting a node.
ΓòÉΓòÉΓòÉ <hidden> Expand ΓòÉΓòÉΓòÉ
Select Expand to display all the direct descendants of the currently selected
node. This choice is unavailable when no node is currently selected.
Related Information:
o Expand All
o Collapse All
o Selecting a node
ΓòÉΓòÉΓòÉ <hidden> Expand All ΓòÉΓòÉΓòÉ
Select Expand All to display all the direct and indirect descendants of the
currently selected node. This choice is unavailable when no node is currently
selected.
Related Information:
o Expand
o Collapse All
o Selecting a node
ΓòÉΓòÉΓòÉ <hidden> Collapse All ΓòÉΓòÉΓòÉ
Select Collapse All to hide all the descendants of the selected node, including
those that are pointed to by other visible nodes. Arcs from other visible
nodes that point to hidden nodes remain visible.
Related Information:
o Expand
o Expand All
o Selecting a node
ΓòÉΓòÉΓòÉ 6.4.3. Collapsed Arcs ΓòÉΓòÉΓòÉ
Select Collapsed Arcs to display the arcs leading to the hidden descendants of
collapsed nodes.
See also Collapse All.
ΓòÉΓòÉΓòÉ 6.4.4. Center ΓòÉΓòÉΓòÉ
Select Center to redraw the graph so that the selected node is in the center of
the screen.
ΓòÉΓòÉΓòÉ 6.4.5. Layout ΓòÉΓòÉΓòÉ
Use Layout to specify whether to draw the graph in a horizontal or vertical
orientation.
Menu Summary
Vertical Draws the graph in a vertical layout.
Horizontal Draws the graph in a horizontal layout. This is the system
default.
ΓòÉΓòÉΓòÉ <hidden> Vertical ΓòÉΓòÉΓòÉ
Select Vertical to draw the graph so that the arcs lie vertically across the
screen. This is the system default.
See also Horizontal.
ΓòÉΓòÉΓòÉ <hidden> Horizontal ΓòÉΓòÉΓòÉ
Select Horizontal to draw the graph so that the arcs lie horizontally across
the screen.
See also Vertical.
ΓòÉΓòÉΓòÉ 6.4.6. Level ΓòÉΓòÉΓòÉ
Use Level to specify the arrangement of the nodes in the graph.
Menu Summary
Top down Draws all the root nodes aligned at the top level.
Even Balances the level placement of root and leaf nodes to reduce arc
length.
Bottom up Draws all the leaf nodes aligned at the bottom level.
ΓòÉΓòÉΓòÉ <hidden> Top Down ΓòÉΓòÉΓòÉ
Select Top down to draw the graph so that all the root nodes are aligned at the
top level.
A Top Down level placement is the system default.
Related Information:
o Even
o Bottom up
ΓòÉΓòÉΓòÉ <hidden> Even ΓòÉΓòÉΓòÉ
Select Even to balance the level placement of the nodes so that arc length is
reduced. Root nodes and leaf nodes are not placed in any particular level.
Related Information:
o Top down
o Bottom up
ΓòÉΓòÉΓòÉ <hidden> Bottom Up ΓòÉΓòÉΓòÉ
Select Bottom up to draw the graph so that the leaf nodes are aligned at the
bottom level.
o Top down
o Even
ΓòÉΓòÉΓòÉ 6.4.7. Magnify ΓòÉΓòÉΓòÉ
Use Magnify to enlarge or reduce a selected portion of the graph. The mouse
pointer changes into a magnification pointer which indicates that you can
select a rectangular portion of the graph to enlarge or reduce. You need a
mouse to use Magnify.
Menu Summary
Area In Expands the selected area to fit the Graph window display.
Area Out Shrinks the currently displayed view of the graph to fit into the
selected area.
Related Information:
o Overview
o Zoom Slider
ΓòÉΓòÉΓòÉ <hidden> Area In ΓòÉΓòÉΓòÉ
Select Area In to expand a selected portion of the graph to fit the Graph
window display. The mouse pointer changes into a magnification pointer with
which you can select the rectangular portion of the graph you want to enlarge.
Drag the pointer along the diagonal of the rectangular area you want to select.
You need a mouse to use Area In.
Other ways to enlarge the graph include Overview and Zoom Slider.
See also Area Out.
ΓòÉΓòÉΓòÉ <hidden> Area Out ΓòÉΓòÉΓòÉ
Select magnify Area Out to shrink the currently displayed view of the graph to
fit into a selected area. The mouse pointer changes into a magnification
selection pointer with which you can select the rectangular portion of the
graph you want to reduce. Drag the pointer along the diagonal of the
rectangular area you want to select. You need a mouse to use Area Out.
Other ways to reduce the graph include Overview and Zoom Slider.
See also Area In.
ΓòÉΓòÉΓòÉ 6.4.8. Zoom ΓòÉΓòÉΓòÉ
Use Zoom to enlarge or reduce the displayed graph while keeping the current
perspective.
Menu Summary
In Enlarges the graph by a single zoom factor.
Out Reduces the graph by a single zoom factor.
Maximum Enlarges the graph to its largest size.
Minimum Reduces the graph to its smallest size.
Related Information:
o Overview
o Zoom Slider
ΓòÉΓòÉΓòÉ <hidden> In ΓòÉΓòÉΓòÉ
Select In to enlarge the graph by a single zoom factor while keeping the
current perspective.
Other ways to enlarge the graph include the Overview option and the Zoom
Slider.
Related Information:
o Out
o Maximum
o Minimum
ΓòÉΓòÉΓòÉ <hidden> Out ΓòÉΓòÉΓòÉ
Select Out to reduce the graph by a single zoom factor while keeping the
current perspective.
Other ways to reduce the graph include the Overview option and the Zoom Slider.
Related Information:
o In
o Maximum
o Minimum
ΓòÉΓòÉΓòÉ <hidden> Maximum ΓòÉΓòÉΓòÉ
Select Maximum to enlarge the graph to its largest size while keeping the
current perspective.
Other ways to enlarge the graph include the Overview option and the Zoom
Slider.
Related Information:
o In
o Out
o Minimum
ΓòÉΓòÉΓòÉ <hidden> Minimum ΓòÉΓòÉΓòÉ
Select Minimum to reduce the graph to its smallest size while keeping the
current perspective.
Other ways to reduce the graph include the Overview option and the Zoom Slider.
Related Information:
o In
o Out
o Maximum
ΓòÉΓòÉΓòÉ 6.4.9. Style ΓòÉΓòÉΓòÉ
Use Style to specify whether to draw the nodes in 2-dimensional or
3-dimensional style.
Menu Summary
2 Dimension Draws the nodes in 2-dimensional style.
3 Dimension Draws the nodes in 3-dimensional style.
ΓòÉΓòÉΓòÉ <hidden> 2D ΓòÉΓòÉΓòÉ
Select 2 Dimension to draw the nodes in a 2-dimensional style. See also 3
Dimension.
ΓòÉΓòÉΓòÉ <hidden> 3D ΓòÉΓòÉΓòÉ
Select 3 Dimension to draw the nodes in a 3-dimensional style. See also 2
Dimension.
ΓòÉΓòÉΓòÉ 6.4.10. Quality ΓòÉΓòÉΓòÉ
Use Quality to set the graph drawing quality for the Graph window. A higher
drawing quality means that crossed arcs are kept to a minimum.
Menu Summary
Very High Draws a very high quality graph at low speed.
High Draws a high quality graph at medium speed.
Medium Draws a medium quality graph at high speed.
Low Draws a lower quality graph at very high speed.
ΓòÉΓòÉΓòÉ <hidden> Very High ΓòÉΓòÉΓòÉ
Use Very High to draw a very high quality graph with minimal crossed arcs at
low speed.
Related Information:
o High
o Medium
o Low
ΓòÉΓòÉΓòÉ <hidden> High ΓòÉΓòÉΓòÉ
Use High to draw a high quality graph with very few crossed arcs at medium
speed. This is the system default.
Related Information:
o Very High
o Medium
o Low
ΓòÉΓòÉΓòÉ <hidden> Medium ΓòÉΓòÉΓòÉ
Use Medium to draw a medium quality graph with some crossed arcs at high speed.
Related Information:
o Very High
o High
o Low
ΓòÉΓòÉΓòÉ <hidden> Low ΓòÉΓòÉΓòÉ
Use Low to draw a low quality graph with many crossed arcs at very high speed.
Related Information:
o Very High
o High
o Medium
ΓòÉΓòÉΓòÉ 6.4.11. Status ΓòÉΓòÉΓòÉ
Use Status to display the Zoom Slider and the parameters of your last Search
Database or Query Object action on status lines near the top of the Graph
window. Status also displays the size of the displayed graph and the name of
the currently selected object.
Menu Summary
Object Displays the object of your last query.
Query Displays the filters of your last database search or object query.
Size Displays the size of the displayed graph in number of nodes.
Selection Displays the name of the currently selected node.
Zoom Displays the Zoom Slider.
All Displays all the Graph window status lines.
None Hides all the visible Graph window status lines.
ΓòÉΓòÉΓòÉ <hidden> Object ΓòÉΓòÉΓòÉ
Select Object status to display the object of your last Query Object action on
the Object status line near the top of the Graph window. A check mark appears
next to your selection.
ΓòÉΓòÉΓòÉ <hidden> Query ΓòÉΓòÉΓòÉ
Select Query status to display the filters of your last Search Database or
Query Object action on the Query status line near the top of the Graph window.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ <hidden> Size ΓòÉΓòÉΓòÉ
Select Size status to display the number of nodes in the displayed graph on the
Size status line near the top of the Graph window.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ <hidden> Selection ΓòÉΓòÉΓòÉ
Select Selection status to display the name of the currently selected object.
A check mark appears next to your selection.
ΓòÉΓòÉΓòÉ <hidden> Zoom ΓòÉΓòÉΓòÉ
Select Zoom status to display the Zoom Slider at the top of the Graph window.
A check mark appears next to your selection.
Related Information:
o Overview
o Magnify
ΓòÉΓòÉΓòÉ <hidden> All ΓòÉΓòÉΓòÉ
Select All status to display all the Graph window status lines.
ΓòÉΓòÉΓòÉ <hidden> None ΓòÉΓòÉΓòÉ
Select None to remove all the visible Graph window status lines.
ΓòÉΓòÉΓòÉ 6.4.12. Relay ΓòÉΓòÉΓòÉ
Select Relay to redraw and recenter the graph with the zoom factor set to zero.
Relay redraws the graph so that it returns to its original appearance.
ΓòÉΓòÉΓòÉ 6.4.13. Reset ΓòÉΓòÉΓòÉ
Select Reset to clear the contents of the Graph window. The window then behaves
like a newly opened window.
ΓòÉΓòÉΓòÉ 7. Text Window ΓòÉΓòÉΓòÉ
Use the Text window to display the all source files in the browser database or
only the source files for a selected object.
You can edit the source-code information from the Text window, however, any
changes you make will not be reflected in the browser database until you
recompile your program. To refresh the browser database after you have
recompiled your updated source code, reload the updated browser files using
Load from the Browser Control window.
Related Information:
o List window
o Graph window
o Browser Control window
ΓòÉΓòÉΓòÉ 7.1. Text ΓòÉΓòÉΓòÉ
Use the Text menu choice to display the occurrences list, save the displayed
file, and make the Browser Control window active.
Pull-down Summary
Occurrences
Displays the occurrences list and allows you to rotate through the
sequence of occurrences.
Save as
Saves the displayed file.
Browser Control
Moves the Browser Control window to the front of the screen and makes
it active.
Close Browser
Closes all browser windows and ends the browser session.
ΓòÉΓòÉΓòÉ 7.1.1. Occurrences ΓòÉΓòÉΓòÉ
Use Occurrences to display the list of occurrences that are accessible from the
Text window, and to rotate through the sequence of occurrences.
Menu Summary
List Displays the list of occurrences for the Text window. You can
select an occurrence to view from this list.
Next Displays the next occurrence in the sequence of occurrences.
Previous Displays the previous occurrence in the sequence of occurrences.
ΓòÉΓòÉΓòÉ <hidden> List ΓòÉΓòÉΓòÉ
Select List to display the list of occurrences in the Text window.
To display an occurrence from the occurrences list:
1. Select Occurrences List from the Text pull-down in the Text window.
2. Select an occurrence from the Occurrences list.
3. Click on Display to display your selected occurrence.
Related Information:
o Next
o Previous
ΓòÉΓòÉΓòÉ <hidden> Next ΓòÉΓòÉΓòÉ
Select Next to display the next occurrence in the occurrences list.
ΓòÉΓòÉΓòÉ <hidden> Previous ΓòÉΓòÉΓòÉ
Select Previous to display the previous occurrence in the occurrences list.
ΓòÉΓòÉΓòÉ 7.1.2. Save as ΓòÉΓòÉΓòÉ
Select Save as to assign a name to the currently displayed file and store it on
disk.
ΓòÉΓòÉΓòÉ 7.2. Browse ΓòÉΓòÉΓòÉ
Select Browse from the menu bar to add objects into the Object List or to
perform a database search or directed query.
Pull-down Summary
Search Database
Perform a search of the browser database.
Query Object
Query a selected object or an object from the Object List.
Copy to Object List
Copy the selected object into the Object List.
ΓòÉΓòÉΓòÉ 7.2.1. Search Database ΓòÉΓòÉΓòÉ
Use Search Database to perform a search on the database when the Object List is
empty or when a query on a specific object is not required. The Search
Database window appears, where you can specify filters for your search.
The result of a database search from a text window is the list of source files
or occurrences that are present in the browser database. Performing a database
search is the first step in examining program source code using the browser.
See also Query Object.
ΓòÉΓòÉΓòÉ 7.2.2. Query Object ΓòÉΓòÉΓòÉ
Use Query Object to query a selected object or an object in the Object List.
The result of an object query from a Text window is a list of locations (called
occurrences) of the focused object in the source files present in the browser
database.
This option is unavailable when the Object List is empty or when no object is
currently selected.
See also Search Database.
ΓòÉΓòÉΓòÉ 7.2.3. Copy to Object List ΓòÉΓòÉΓòÉ
Use Copy to Object List to copy a displayed object into the browser Object
List.
To copy an object into the Object List:
1. Select an object such as a node, list item, or text fragment, from a
browser List, Graph, or Text window.
2. Select Copy to Object List from the Browse pull-down to copy your selected
object into the Object List.
Alternatively, you can double-click on a displayed object to automatically copy
the selected item into the Object List and open the Query Object window with
the selected item as the query object.
ΓòÉΓòÉΓòÉ 7.3. Edit ΓòÉΓòÉΓòÉ
Use Edit to work with selected text, to undo editing changes, and to find and
replace text.
Pull-down Summary
Browse only
Disables editing in the Text window.
Cut
Removes the selected portion of data from the Text window and places it into
the OS/2* clipboard.
Copy
Copies the selected portion of data from the Text window into the clipboard.
Paste
Copies the contents of the clipboard into the Text window starting from the
current cursor position.
Clear
Removes the selected portion of data from the Text window. The removed data
is not copied into the clipboard.
Undo
Reverses the most edit action.
Find
Finds a text string within the displayed file.
Find next
Repeats the last action specified by the most recent Find operation starting
from the current cursor position.
Replace
Finds and replaces the first occurrence of a text string by another text
string.
Replace next
Repeats the last action specified by the most recent Replace operation
starting from the current cursor position.
See also Selecting text in the Text window.
ΓòÉΓòÉΓòÉ 7.3.1. Browse Only ΓòÉΓòÉΓòÉ
Use Browse only to disable editing in the Text window. This option is active by
default.
A check mark appears next to your selection when this option is active.
ΓòÉΓòÉΓòÉ 7.3.2. Cut ΓòÉΓòÉΓòÉ
Use Cut to remove the selected text to the clipboard for transfer to another
location.
Cut is unavailable when no data is currently selected.
Related Information:
o Selecting text
o Copy
o Paste
o Clear
o Undo
ΓòÉΓòÉΓòÉ 7.3.3. Copy ΓòÉΓòÉΓòÉ
Use Copy to copy the selected text to the clipboard for transfer to another
location.
This option is unavailable when no data is currently selected.
Related Information:
o Selecting text
o Cut
o Paste
o Clear
o Undo
ΓòÉΓòÉΓòÉ 7.3.4. Paste ΓòÉΓòÉΓòÉ
Use Paste to copy text from the clipboard to the displayed file at the current
cursor position. The Paste operation is usually preceded by one or more Cut or
Copy operations.
This option is unavailable when the clipboard is empty.
Related Information:
o Clear
o Undo
ΓòÉΓòÉΓòÉ 7.3.5. Clear ΓòÉΓòÉΓòÉ
Use Clear to cut the selected portion of the data from the Text window without
copying it into the clipboard.
This option is unavailable when no data is currently selected.
Related Information:
o Selecting text
o Cut
o Copy
o Undo
ΓòÉΓòÉΓòÉ 7.3.6. Undo ΓòÉΓòÉΓòÉ
Use Undo to reverse the most recent edit action.
ΓòÉΓòÉΓòÉ 7.3.7. Find ΓòÉΓòÉΓòÉ
Use Find to locate a text string within the displayed file starting from the
current cursor position.
This option is unavailable when the Text window is empty.
See also Find next.
ΓòÉΓòÉΓòÉ 7.3.8. Find next ΓòÉΓòÉΓòÉ
Use Find next to find the next occurrence of the text string specified in the
most recent Find operation.
The options that were active in the last Find operation remain active for any
subsequent Find next operations. The Find next action is always performed from
the current cursor position.
This option is unavailable when the Text window is empty or when a Find
operation has not yet been performed.
ΓòÉΓòÉΓòÉ 7.3.9. Replace ΓòÉΓòÉΓòÉ
Use Replace to find and replace a specified text string within the contents of
the Text window. The Replace window appears where you can enter the text to
find and replace and where you can specify options for the Replace action.
See also Replace next.
ΓòÉΓòÉΓòÉ 7.3.10. Replace next ΓòÉΓòÉΓòÉ
Replace next repeats the action specified by the most recent Replace operation.
ΓòÉΓòÉΓòÉ 7.4. View ΓòÉΓòÉΓòÉ
Use View to reset the Text window, or to display status information on the
displayed file, and your last database Search or object Query.
Pull-down Summary:
What is Displays a definition of the selected element in a pop-up window.
The selected string must be a valid name in the browser database.
Status Displays the size and name of the currently displayed file and the
parameters of your last database search or object query.
Reset Clears the contents of the Text window.
ΓòÉΓòÉΓòÉ 7.4.1. What is ΓòÉΓòÉΓòÉ
Select What is to display a definition of the selected text in a pop-up window.
The selected text must be a valid name in the browser database.
ΓòÉΓòÉΓòÉ 7.4.2. Status ΓòÉΓòÉΓòÉ
Use Status to display the size and name of the currently displayed file and the
parameters of your last Search Database or Query Object action on status lines
near the top of the Text window.
Menu Summary
Object
Displays the object of your last object query.
Query
Displays the filters of your last database search or object query.
Size
Displays the size of the displayed file in number of lines.
Occurrence
Displays the name of the currently displayed occurrence.
All
Displays all the Text window status lines.
None
Hides all the visible Text window status lines.
ΓòÉΓòÉΓòÉ <hidden> Object ΓòÉΓòÉΓòÉ
Select Object to display the object of your last Query on the Object status
line near the top of the Text window.
ΓòÉΓòÉΓòÉ <hidden> Query ΓòÉΓòÉΓòÉ
Select Query status to display the filters of your last Search Database or
Query Object action on the Query status line near the top of the Text window.
ΓòÉΓòÉΓòÉ <hidden> Size ΓòÉΓòÉΓòÉ
Select Size status to display the size of the currently displayed file on the
Size status line near the top of the Text window. Size is displayed in number
of lines.
ΓòÉΓòÉΓòÉ <hidden> Occurrence ΓòÉΓòÉΓòÉ
Select Occurrence status to display the name of the currently displayed file on
the Occurrence status line near the top of the Text window.
ΓòÉΓòÉΓòÉ <hidden> All ΓòÉΓòÉΓòÉ
Select All status to display all the Text window status lines.
ΓòÉΓòÉΓòÉ <hidden> None ΓòÉΓòÉΓòÉ
Select None to remove all the visible Text window status lines.
ΓòÉΓòÉΓòÉ 7.4.3. Reset ΓòÉΓòÉΓòÉ
Select Reset to clear the contents of the Text window. The window then behaves
like a newly opened window.
ΓòÉΓòÉΓòÉ 8. Keys Help ΓòÉΓòÉΓòÉ
To view the key definitions for each browser window type, select a window type
from the list below:
o Browser Control Window
o List Window
o Graph Window
o Text Window
ΓòÉΓòÉΓòÉ 8.1. Browser Control Window Keys Help ΓòÉΓòÉΓòÉ
Ctrl+L Open a new List window.
Ctrl+G Open a new Graph window.
Ctrl+T Open a new Text window.
F3 Exits the browser.
ΓòÉΓòÉΓòÉ 8.2. List Window Keys Help ΓòÉΓòÉΓòÉ
o Accelerator Keys
Ctrl+B Move to the Browser Control window.
Ctrl+S Performs a database search.
Ctrl+Q Performs an object query.
Ctrl+C Copies the selected object into the Object List.
Ctrl+F Finds a specified text string in the list.
Ctrl+X Repeats the last action specified by the last Find operation by
invoking Find next.
F3 Exits the browser.
o Selection Keys
Spacebar Toggles the selection state of the list item on which the cursor
is positioned.
o Cursor Movement Keys
Tab Shifts the focus between the list display and the List window
status lines.
PgDn Scrolls one page downward.
PgUp Scrolls one page upward.
Ctrl+PgUp Scrolls left one page.
Ctrl+PgDn Scrolls right one page.
Home Moves the cursor to the first item in the list.
End Moves the cursor to the last item in the list.
Ctrl+Home Moves the cursor to the first item in the list.
Ctrl+End Moves the cursor to the last item in the list.
Moves cursor up one list item, if possible.
Moves cursor down one list item, if possible.
ΓòÉΓòÉΓòÉ 8.3. Graph Window Keys Help ΓòÉΓòÉΓòÉ
o Accelerator Keys
Ctrl+B Moves to the Browser Control window.
Ctrl+S Performs a database search.
Ctrl+Q Performs an object query.
Ctrl+C Copies the selected object into the Object List.
Ctrl+0 Displays the Overview window.
Alt+ Enlarges the graph by a single zoom factor.
Alt+ Reduces the graph by a single zoom factor.
Alt+Home Enlarges the graph to its maximum size.
Alt+End Reduces the graph to its minimum size.
Alt+ Collapses the selected node.
Alt+ Expands the selected collapsed node to show all its direct and
indirect descendants.
Alt+E Expands the selected collapsed node to show all its direct
descendants.
Ctrl+F Finds a specified node in the graph.
Ctrl+X Repeats the last action specified by the last Find operation by
invoking Find next.
Alt+C Centers the selected node on the screen.
F3 Exits the browser.
o Selection Keys
Spacebar De-selects the currently selected node.
Establishes a selection on the root node of the graph when there
is no node currently selected. When there is a node selected,
this key moves the selection up one node, if possible.
o Cursor Movement Keys
Tab Shifts the focus between the graph display and the graph window
status lines.
PgDn Scrolls one page downward.
PgUp Scrolls one page upward.
Ctrl+PgUp Scrolls left one page.
Ctrl+PgDn Scrolls right one page.
Home Moves the node selection (cursor) to the beginning of the
current node level.
End Moves the node selection to the end of the current node level.
Ctrl+Home Moves the node selection to the first node in the graph.
Ctrl+End Moves the node selection to the last node in the graph.
Moves the node selection up one node, if possible.
Moves the node selection down one node, if possible.
Moves the node selection left one node.
Moves the node selection right one node.
ΓòÉΓòÉΓòÉ 8.4. Text Window Keys Help ΓòÉΓòÉΓòÉ
o Accelerator Keys
Ctrl+B Moves to the Browser Control window.
Ctrl+S Performs a database search.
Ctrl+Q Performs an object query.
Ctrl+C Copies the selected object into the Object List.
F8 Displays the occurrences list.
F12 Move to the next occurrence in the occurrences list.
F11 Move to the previous occurrence in the occurrences list.
Ctrl+W Invokes a What is action.
Ctrl+F Finds a specified string in the displayed text.
Ctrl+X Repeats the action specified by the last Find operation by
invoking Find next.
Ctrl+R Invokes a Replace action.
Ctrl+E Repeats the action specified by the most recent Replace
operation.
F3 Exits the browser.
o Cursor Movement Keys
Tab Shifts the focus between the text display and the text window
status lines.
PgDn Scrolls one page downward.
PgUp Scrolls one page upward.
Ctrl+PgUp Scrolls left one page.
Ctrl+PgDn Scrolls right one page.
Home Moves the cursor to the beginning of the current line.
End Moves the cursor to the end of the current line.
Ctrl+Home Moves the cursor to the beginning of the file.
Ctrl+End Moves the cursor to the end of the file.
Moves cursor up one line, if possible.
Moves cursor down one line, if possible.
Moves cursor left one character position, if possible.
Moves cursor right one character position, if possible.
Ctrl+ Moves the cursor one word to the left.
Ctrl+ Moves the cursor one word to the right.
o Selection Keys
Shift+ Extends selection one character position to the right.
Shift+ Extends selection one character position to the left.
Shift+ Extends selection to the current character position on the line
below the current line.
Shift+ Extends selection to the current character position on the line
below the current line.
o Editing Keys
Shift+Del Removes the selected text to the OS/2* clipboard.
Ctrl+Ins Copies the selected text to the OS/2 clipboard.
Shift+Ins Copies the contents of the OS/2 clipboard into the displayed text
starting at the current cursor position.
Del Removes the selected text without copying it to the OS/2
clipboard.
Ins Toggles between insert and replace modes in text entry.
Alt+Bkspc Reverses the most recent Cut or Paste action.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The application cannot read the corrupted browser file.
Recovery:
Exit the browser then re-generate the browser file by compiling the source
again with the /Fb option.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The browser was unable to recognize the selected text as a valid database
object. This may be caused by one or both of the following reasons:
o The selected item is not a valid object in the database
o The source file has been changed so the browser can no longer recognize the
object from its exact placement in the original text.
Recovery:
Refresh the browser database by unloading the appropriate browser file,
re-compiling the source with the /Fb option, then re-loading the generated
browser file into the browser database.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The application was unable to find the standard OS/2* executable files VIEW.EXE
and VIEWDOC.EXE along the paths specified in the PATH environment variable.
These files are necessary for viewing the browser tutorial.
Recovery:
Make sure these files are present in your system and that they are visible
along the PATH environment variable in your CONFIG.SYS file.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation and Recovery:
The application was unable to find the browser tutorial file DDE4BTUT.INF along
the paths specified by the HELP environment variable.
Recovery:
Make sure the file is present in your system and that it is visible along the
HELP environment variable in your CONFIG.SYS file.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The application was unable to write to your specified file. This may be caused
by one of the following reasons:
o The drive was not ready. Make sure there is a diskette in the drive you want
to save the file to.
o The diskette or disk you wanted to write to may be full. Delete some files
or specify another disk to write to.
o The diskette or disk may be write-protected. Remove the write protection on
the disk to save the file on it.
o The specified path may not exist in your system. If you have made a typing
error, re-enter the path. Otherwise, create the path on your system or
specify another path.
o The file permissions may be set to read-only. Change the file permission to
allow writes or specify another filename to save the file to.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
Trademark of the IBM Corporation
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
A check mark is a symbol that shows that an option is currently active.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
A leaf node is a node with no descendants.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
A root node is a node with no ascendants.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
A name is an alphanumeric term that identifies any program element or object in
the browser database.