OS/2 Shareware BBS: 10 Tools/10-Tools.zip/cset21v1.zip/IBMCPP/HELP/DDE4BHLP.HLP

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.