Power GUI Programming with VisualAge C++/powergui.iso/trialva/ibmcppw/help/cppwbr35.hlp

OS/2 Help File | 1996-02-22 | 142.8 KB | 3,213 lines

ΓòÉΓòÉΓòÉ 1. Getting Help ΓòÉΓòÉΓòÉ

The Browser comes with 3 sources of information:

 How Do I...  The Browser: How Do I... information is a list of Browser
      specific tasks with step-by-step solutions, such as "How do I browse my
      files without having to recompile them". The tasks cover a wide range of
      things that you may want to do with the Browser. If you are ever stuck
      wondering how to do something, check the How Do I... information. If you
      want to know how to use any of the other VisualAge for C++ tools, use the
      How Do I... Selections Cascade menu on the Help PullDown menu to access
      the various How Do I... information available for VisualAge for C++. To
      get general VisualAge for C++ usage or programming techniques, use the
      VisualAge for C++: How Do I... information.

 User's Guide  The User's Guide provides information on how to use the Browser.
      This information is not as exhaustive as the How Do I... help as far as
      covering all tasks, but it does provide more of the conceptual
      information that you may need to know in order to understand the
      fundamentals of the Browser.

 Online Help  You are currently viewing the online help. Use the online help to
      help you understand the various components of the Browser interface. It
      will give you advice on how to use and fill in the various windows and
      dialogs, as well as show you the meaning of the PullDown and PopUp menu
      items.


ΓòÉΓòÉΓòÉ 2. Keys Help ΓòÉΓòÉΓòÉ

The following two lists outline the fast-path keys for using the Browser. The
format is as follows:

 <key>
 or
 <key> - <key>

 Note:   The letter keys are shown in uppercase for clarity. You do NOT have to
         press the Shift key unless this key is specifically mentioned.

 Application-Provided Keys:

 F3        Close the Browser session
 F5        Refresh the currently loaded Browser database file
 F6        Perform the previous  object-action pair.
 F7        Expand all the items in the List window container view
 F8        Collapse all the items in the List window container view
 Ctrl-C    Centers the currently selected node on a graph
 Ctrl-E    Edit the currently selected definition or file
 Ctrl-F    Initiate Find dialog to find text in the current window.
 Ctrl-G    Graph all the base and derived classes for the currently selected
           class
 Ctrl-H    Show the documentation for the currently selected class or function
 Ctrl-L    List all members with inheritance for the currently selected class
 Ctrl-N    Find next instance of text in the current window.
 Ctrl-S    Initiate Search dialog to search for text in the loaded Browser
           database.
 Ctrl-Insert Copies the current window contents to the clipboard.
 Ctrl-+ (Use only the Numeric keypad) Zoom in on a graph.
 Ctrl-- (Use only the Numeric keypad) Zoom out on a graph.
 Alt-+     Maximum zoom in on a graph
 Alt--     Maximum zoom out on a graph

 System-Provided Keys:

 Alt-F4    Close window


ΓòÉΓòÉΓòÉ 3. What are Browser Objects? ΓòÉΓòÉΓòÉ

The Browser presents program elements to you in the form of objects on the
screen. Objects can be classes, types, functions, variables, and source files.
In addition, the Browser uses Label objects to organize the program elements in
the List window container view. You can click Mouse Button 2 on any of these
objects to invoke a PopUp menu of actions available for that object.

To find out more about these objects and the actions that you can invoke on
them, click on any of the following:

        Class Object
        Function Object
        Variable Object
        Type Object
        File Object
        Label Object


ΓòÉΓòÉΓòÉ 3.1. Class Object ΓòÉΓòÉΓòÉ

Various C++ program objects are referred to as class objects: C++ classes,
structs, unions, class templates, and class template instantiations. It
includes those classes defined at file (or global) scope and those nested
inside of other classes. It does not include classes defined inside of function
bodies.

Class objects have been specialized for SOM. A SOM class is a class derived
from SOMObject, and a SOM metaclass is a class derived from SOMClass. C++
Direct-To-SOM classes are supported by the Browser. Bindings from the C++ SOM
emitter may also be browsed, but the symbols produced by the emitter may not be
easy to read or understand. SOM classes and metaclasses have the same PopUp
menus and double click actions as regular classes, but you can change the color
and shape to make them stand out visually in the Browser.

In the Browser, by default, classes are displayed in cyan text, SOM classes are
displayed in dark green text, and SOM metaclasses are displayed in light green
text. You can change the default colors in either the List window or Graph
window using the List Window Settings NoteBook Colors page or the Graph Window
Settings NoteBook Colors page, respectively.

While the mouse pointer is over the class object, click Mouse Button 2 to
display the Class PopUp menu. The following functions are available for class
objects:

        Edit Definition
        Show Documentation
        Graph All Base & Derived Classes
        Graph All Base Classes
        Graph All Derived Classes
        Graph Immediate Derived Classes
        List Members with Inheritance
        List Friends
        List Friendships
        List Implementing Files
        List Instantiations

 Depending on the program or library that you are browsing, some of these menu
 actions may be disabled if the Browser knows that there is no application
 information for that action.

 The following menu items are available from a List window container view.

 Expand
 Collapse

 The following menu item is available from a Graph window only:

 Center

 Note:   When you QuickBrowse your source files that contain class template
         instantiations, the instantiations will not be listed in the List All
         Classes, output. In fact, the instantiations will not exist in the
         Browser database. What you will find in the database is the correct
         name/type of the instantiation given as the type of the (member)
         variable that is an instance of that instantiation, given that
         QuickBrowse sees the declaration of the variable. Note that the List
         Instantiations action will always result in the No Results Found
         message, even though these template instantiations are found.


ΓòÉΓòÉΓòÉ 3.2. Function Object ΓòÉΓòÉΓòÉ

Various C++ program objects are referred to as function objects: functions,
member functions, function templates, function template instantiations, and SOM
methods. It does not include class member functions defined inside of function
bodies.

Function objects are displayed in blue text. You can change this default color
in the List window or Graph window using the List Window Settings NoteBook
Colors page or the Graph Window Settings NoteBook Colors page, respectively.

In the List window, there may be a light blue letter at the start of the
function name. These letters represent the following attributes:

 C    Constant
 V    Virtual
 S    Static
 PV   Pure Virtual

 While the mouse pointer is over the function object, click Mouse Button 2 to
 display the Function PopUp menu. The following functions are available for
 function objects:

        Edit Definition
        Show Documentation
        Graph All Callers
        Graph All Callees
        Graph All Callers & Callees
        Graph Immediate Callers & Callees
        List Immediate Callers & Callees
        List Possible Exceptions Thrown
        List Overriding Derived Classes
        List Friendships
        List Instantiations
        List Class Members with Inheritance

 Depending on the program or library that you are browsing, some of these menu
 actions may be disabled if the Browser knows that there is no application
 information for that action.

 The following menu item is available from a Graph window only:

 Center


ΓòÉΓòÉΓòÉ 3.3. Variable Object ΓòÉΓòÉΓòÉ

Various C++ program objects are referred to as variable objects: variables,
class member variables, class template member variables, member variables of
class template instantiations, and SOM data members. It does not include
variables defined inside of function bodies.

Variable objects are displayed in blue text and only appear in List windows.
You can change this default color in the List window using the List Window
Settings NoteBook Colors page.

In the List window, there may be a light blue letter at the start of the
variable name. This letter represents the following attribute:

 S    Static

 While the mouse pointer is over the variable object, click Mouse Button 2 to
 display the Variable PopUp menu. The following function is available for
 variable objects:

        Edit Definition

 Note:   When you QuickBrowse your source files that contain class template
         instantiations, the instantiations will not be listed in the List All
         Classes, output. In fact, the instantiations will not exist in the
         Browser database. What you will find in the database is the correct
         name/type of the instantiation given as the type of the (member)
         variable that is an instance of that instantiation, given that
         QuickBrowse sees the declaration of the variable. Note that the List
         Instantiations action will always result in the No Results Found
         message, even though these template instantiations are found.


ΓòÉΓòÉΓòÉ 3.4. Type Object ΓòÉΓòÉΓòÉ

Two C++ program objects are referred to as type objects: typedefs and enums. It
does not include enumeration values, nor does it include those enums and
typedefs declared inside of function bodies, or built-in C types, such as int
or char. Classes, structs and unions are referred to as class objects.

Type objects are displayed in blue text and only appear in List windows. You
can change this default color in the List window using the List Window Settings
NoteBook Colors page.

In the List window, there may be a light blue letter at the start of the type
name. This letter represents the following attribute:

 E    Enumerator

 While the mouse pointer is over the type object, click Mouse Button 2 to
 display the Type PopUp menu. The following functions are available for type
 objects:

        Edit Definition
        Expand Typedef

 Note that the Expand Typedef option is only enabled if the currently selected
 object is a typedef.


ΓòÉΓòÉΓòÉ 3.5. File Object ΓòÉΓòÉΓòÉ

File objects are displayed in red text. You can change this default color in
the List window or Graph window using the List Window Settings NoteBook Colors
page or the Graph Window Settings NoteBook Colors page, respectively.

While the mouse pointer is over the file object, click Mouse Button 2 to
display the File PopUp menu. The following functions are available for file
objects:

        Edit File
        Graph All Includers
        Graph All Includees
        Graph All Includers & Includees
        List Defined Objects

 The following menu item is available from a Graph window only:

 Center


ΓòÉΓòÉΓòÉ 3.6. Label Object ΓòÉΓòÉΓòÉ

When you perform one of the following actions:

 o List Members with Inheritance on a class
 o List Friends on a class
 o List Class Members with Inheritance on a function
 o List Defined Objects on a file
 o List Immediate Callers & Callees on a function
 the results are placed in a List window container view. In this type of view,
 Label objects are used to organize the results in the List window by category.
 Categories can be nested and include Public, Protected, Private,
 Constructors/Destructors, Classes, Functions, Types, Variables, Callers, and
 Callees. Also, the results displayed when you expand a typedef are label
 objects.

 Label objects are displayed in brown text and only appear in the List window.
 You can change this default color in the List window using the List Window
 Settings NoteBook Colors page.

 While the mouse pointer is over the label object, click Mouse Button 2 to
 display the Label PopUp menu. The following functions are available for label
 objects:

        Expand
        Collapse

 Note that those label objects which do not have a or , do not have a PopUp
 menu because there are no items grouped under them. Use Mouse Button 1 on the
 to expand the object one level, and on the to collapse the levels below it.
 Also, to expand the entire container view contents, use the F7 key. To
 collapse the entire container view contents, use the F8 key.


ΓòÉΓòÉΓòÉ 4. Browser Windows and Dialogs ΓòÉΓòÉΓòÉ

The Browser has two kinds of windows (List and Graph) that you can use to list
program elements and graph program relationships. There are several dialogs
which can be used:

For Customization

 o Browser Settings NoteBook
      Pages: Paths and Help Level
 o List Window Settings NoteBook
      Pages: Settings, Colors, and Styles
 o Graph Window Settings NoteBook
      Pages: Settings, Colors, Styles, and Bitmap

 To Perform Actions

 o Load Database Dialog
 o Merge Database Dialog
 o Save As Dialogs
 o Browser Print Dialog
      Setup: Print Setup and Page Setup
 o Find Dialog
 o Search Database Dialog
 o History Window
 o Font Dialogs
 o Browser Files Dialog
 o Profile Dialog
 o Choose Object Dialog

 For Information

 o New User Help Dialog
 o Overview Window
 o Progress Dialog


ΓòÉΓòÉΓòÉ 4.1. List Window Help ΓòÉΓòÉΓòÉ

The List window displays a list of program elements. Many aspects of a program
or library can be described as a list. Other aspects can be described as
relationships in a Graph window. Program elements are grouped in the Browser by
the type of object they represent. These groups are described in Browser
Objects.

To browse your programs, use the Load Database dialog.

The List window consists of:

 o A main menu bar whose PullDown menu actions affect the current window.
 o An Action Status Bar which describes what object and action produced the
   currently viewed list.
 o A count that indicates how many program elements are in the current list,
   excluding label objects.
 o A Hold CheckBox that, when checked, keeps the current List window contents
   from being replaced when an object-action pair results in a list. This can
   be useful, for instance, if you want to keep a list of all classes available
   at the same time that you want to focus on one given class. If the Hold
   CheckBox is not checked (the default behavior), the results of the next
   action overwrites the current window contents. There is a limit of four List
   windows.
 o A List Area where your program objects are listed. You can perform actions
   on the contents of the List Area using Mouse Button 2 on any of the listed
   items or on the background of the List window. You can also print, save to a
   file, or copy to the clipboard the contents of the List window.
 o An Information Bar at the bottom of the window quickly defines the currently
   selected menu item or explains how to invoke the Object PopUp menus. You can
   hide the Information Bar by selecting the Expert help level in the Browser
   Settings NoteBook.

 The List window has a Background PopUp menu which allows you to perform
 actions on the window. You can access this PopUp using Mouse Button 2 on the
 background of the List window.

 When you are viewing the members of a class, the List window displays the
 members in a hierarchical view called the container view. You can use the and
 icons or the F7 and F8 keys to expand or collapse the various objects of the
 class.

 You can alter the settings for the List window using the List Window Settings
 NoteBook.


ΓòÉΓòÉΓòÉ 4.2. Graph Window Help ΓòÉΓòÉΓòÉ

A Graph window displays relationships between program objects graphically. Many
aspects of a program or library can be described as relationships between
program elements. Other aspects can best be described by listing some group of
elements in a List window. Program elements are grouped in the Browser by the
type of object they represent. These groups are described in Browser Objects.

To browse your program relationships, use the Load Database dialog.

The Graph window consists of:

 o A main menu bar whose PullDown menu actions affect the current window.
 o An Action Status Bar which describes what object and action produced the
   currently viewed graph.
 o A count that indicates how many program elements (nodes) are in the current
   graph.
 o A Hold CheckBox that, when checked, keeps the current Graph window contents
   from being replaced when an object-action pair results in a graph. This can
   be useful, for instance, if you want to keep an inheritance graph available
   at the same time that you want to focus on another relationship. If the Hold
   CheckBox is not checked (the default behavior), the results of the next
   action overwrites the current window contents. There is a limit of four
   Graph windows.
 o A Graph Area that contains the graphical results of your object-action pair.
   You can perform actions on the contents of the Graph Area using Mouse Button
   2 on any of the nodes or on the background of the Graph window. You can also
   print, save to a file, or copy to the clipboard the contents of the Graph
   Area. When you select a node on the graph, the selected item is highlighted
   in the List Area of the Graph window.
 o A List Area that alphabetically lists all the nodes on the graph. You can
   click on the items in this list to see where in the graph the node appears.
   This node is highlighted in red, by default. You can perform actions on the
   contents of the List Area using Mouse Button 2 on any of the listed items or
   on the background of the List window. You can also save the contents of the
   List Area to a file.
 o A Slider on the left side to quickly zoom in and out on the graph. Move the
   Slider up to decrease the magnification of the graph and down to increase
   the magnification.
 o Scroll bars located on the right side and bottom of the Graph Area. Use
   these to scroll the Graph Area horizontally and vertically.
 o A divider located between the Graph Area and List Area. Use it to change the
   proportion of the screen allocated to each area.
 o An Information Bar located at the bottom of the window that briefly
   describes the currently selected menu item or explains how to invoke the
   Object PopUp menus. You can hide the Information Bar by selecting the Expert
   Help level in the Browser Settings NoteBook.

 A very large number of nodes may exhaust the system resources, though there is
 no set limit on the number of nodes that you can view within the Browser. Note
 that it would be very difficult to comprehend the type of graph that would
 exhaust the system resources.

 The Graph Area has a Background PopUp menu which allows you to perform actions
 on the window, such as, specifying the level of detail you want the graph to
 show, scrolling over the graph, zooming in and out, and changing the layout
 parameters. You can access this PopUp using the Mouse Button 2 on the
 background of the Graph Area.

 You can select a portion of the Graph Area by clicking and dragging the mouse
 over the area that you want to select. You can then get a PopUp menu specific
 for the selected region which allows you to zoom in on, copy, save, or print
 the selected area.

 You can alter the settings for the Graph window using the Graph Window
 Settings NoteBook.


ΓòÉΓòÉΓòÉ 4.3. Browser Settings NoteBook Help ΓòÉΓòÉΓòÉ

Use the Browser Settings NoteBook to set options which are used by the overall
Browser environment. It has two pages:

 o Paths
 o Help Level

 You can also set options for the List and Graph windows using the List Window
 Settings NoteBook and the Graph Window Settings NoteBook.


ΓòÉΓòÉΓòÉ 4.3.1. Paths Page Help ΓòÉΓòÉΓòÉ

Use the Browser Settings Paths page to specify the path names that the Browser
should use in searching for Browser files and library files. You can also
specify where to store the Browser profile (ibrs.ini).

Use the File Search Path TextEntry field to enter directory names where you
want the Browser to search for files. By default, the path name contains the
INCLUDE environment variable of the IBM VisualAge for C++ Open Class Library.
Add your own directories to this list in the order in which the search should
be performed. Place a semicolon (;) after each directory. If two directory
names in the search path contain a file with the same file name, the file in
the first directory will be used.

Use the Library Files TextEntry field to enter the names of the library files
(.LIB) that your program uses, but where you do not want to see the Browser
information for those files. Such files are from another vendor or files whose
internals are not important to you. The files you specify here will most likely
be those that you know do not contain any relevant Browser information. By
default, the IBM VisualAge for C++ Open Class Library files are added to this
list because they do not contain any Browser information. These library files
are not used when the Browser loads all relevant information pertaining to your
program or library. Place a semicolon (;) after each file name.

You may prefer, or need to, keep the Browser profile (ibrs.ini) in a location
different from the one you specified when you first used it. You can use the
Profile TextEntry field to change its location. When you exit the Browser, it
will create the profile in this new location.

Use the OK PushButton to accept the changed pathnames. The new settings will be
saved to the Browser profile (ibrs.ini) when you exit the Browser.

Use the Cancel PushButton to close the dialog without changing the path names.
Use the Default PushButton to reset the path and file names to the Browser
defaults.

Note:   When you list files in the Browser, the paths where these files were
        when the program was created will be listed. These paths may not
        necessarily be correct, as may be the case with the Browser shipped
        .PDL files for the IBM VisualAge for C++ Open Class Library that you
        can access from the Load > or Merge > Cascade menus.


ΓòÉΓòÉΓòÉ 4.3.2. Help Level Page Help ΓòÉΓòÉΓòÉ

Use the Help Level page to change the level of help provided by the Browser,
and to disable the Close Browser Dialog.

You can set the level of help that the Browser provides:

 New user      New User Help and an Information Bar is provided.
 Intermediate  No New User Help, but an Information Bar is provided.
 Expert        No New User Help and no Information Bar provided.

 The Information Bar is located at the bottom of each Browser window and is
 used to describe the various menu items as you highlight them.

 You can turn off the Close Browser dialog which appears each time you close
 the Browser by deselecting the Confirm on exit CheckBox.


ΓòÉΓòÉΓòÉ 4.4. List Window Settings NoteBook Help ΓòÉΓòÉΓòÉ

Use the List Window Settings NoteBook to set options which are used by the List
windows. The List Windows Settings NoteBook contains three pages:

 o Settings
 o Colors
 o Styles

 You can also set options for the Browser and Graph window using the Browser
 Settings NoteBook and the Graph Window Settings NoteBook.


ΓòÉΓòÉΓòÉ 4.4.1. Settings Page Help ΓòÉΓòÉΓòÉ

The List Window Settings NoteBook Settings page allows you to change the
default display characteristics of the List window.

You can change the Action Status Bar font independently of the font used in the
List Area of the List window. Select the Select... PushButton to display the
Action Status Bar Font dialog. You can select the type of font, the size of
font, the style of font (bold or italics), and the emphasis (outline, underline
or strikeout). Note that the font used here is set independently from the font
set for the Graph window Action Status Bar.

Use the Initial Action DropDown to select the action that is performed in the
first List window when you load a new file into the Browser (List All Classes,
List All Files, or None).

Use the Double Click Actions section to change the default action that is
performed when you double-click on an object in the List window. By default,
all double-click actions on objects in the List window are set to edit. Select
the object and corresponding action. Note that the Browser is able to detect
whether an action is available for a given object, and will disable that action
on the corresponding PopUp menu. Thus, if you have selected a default action
which is not available for a particular object, the Browser will provide you
with a message relating this fact. Note that the double-click action for
objects in the Graph  window are set independently from the settings made in
the List window.

Use the OK PushButton to accept the default changes. These settings will be
saved to the Browser profile (ibrs.ini) when you exit the Browser.

Use the Cancel PushButton to cancel the changes you have made. Use the Default
PushButton to reset to the default Browser settings for List windows.


ΓòÉΓòÉΓòÉ 4.4.2. Colors Page Help ΓòÉΓòÉΓòÉ

Use the Colors page to customize the colors used in the List window. The colors
are set independently from the colors used by the Graph window.

Note that making a color change will affect all open List windows and all
subsequently opened List windows. The new defaults are saved to the Browser
profile (ibrs.ini) when you exit the Browser.

On the left side of the page is a scrollable list of items for which you can
set colors. On the upper right side is the color palette containing 16 colors
to choose from. On the bottom right side is an Example Area that will give you
a preview of the color selection that you are currently editing.

To change an object's color:

  1. Select the object from the scrollable list.
  2. Click on the color from the 16 available colors. Your change appears in
     the Example Area.
  3. Select the OK PushButton if you want to apply your color changes to the
     List Window, or select the Cancel PushButton if you want to exit without
     making any changes.

 The Default PushButton restores the default colors used by the Browser List
 windows. By default, the color settings are:

 Object                   Color
 Class                    Cyan
 SOM Class                Dark Green
 SOM Metaclass            Light Green
 Function                 Blue
 Variable                 Blue
 Type                     Blue
 File                     Red
 Label                    Brown
 Background               White
 Attribute Foreground     Dark Red
 Attribute Background     Light Blue
 Action Status Bar Foreground Blue
 Action Status Bar Background White


ΓòÉΓòÉΓòÉ 4.4.3. Styles Page Help ΓòÉΓòÉΓòÉ

Use the Styles page to change the amount of text displayed in the List window.
There are three text style settings:

 Attributes  Summarizes what the program element is (C-constant, V-virtual,
             E-enumerator, S-static, and PV-pure virtual).
 Full Text   Lists the full text of the program elements.
 Both        Lists both the summary and full text of the program elements.

 The Example area shows what the List window text will look like if you choose
 the different options. Select OK to accept the changes and Cancel to exit
 without making changes.


ΓòÉΓòÉΓòÉ 4.5. Graph Window Settings NoteBook Help ΓòÉΓòÉΓòÉ

Use the Graph Window Settings NoteBook to set options which are used by the
Graph windows. The Graph Windows Settings NoteBook contains four pages:

 o Settings
 o Colors
 o Styles
 o Bitmap

 You can also set options for the Browser and List window using the Browser
 Settings NoteBook and the List Window Settings NoteBook.


ΓòÉΓòÉΓòÉ 4.5.1. Settings Page Help ΓòÉΓòÉΓòÉ

Use the Settings page to change the Action Status Bar font, the initial action
performed when you load a file into the Browser, and the double-click actions
of the objects displayed in the Graph window.

To change the font of the Action Status Bar on the Graph window, choose the
Select... PushButton to display the Action Status Bar Font dialog. You can
select the type of font, the size of font, the style of font (bold or italics),
and the emphasis (outline, underline or strikeout). Note that the font used
here is set independently from the font set for the List window Action Status
Bar.

Use the Initial Action DropDown to select the action to perform when loading a
program into the Browser. The Graph window does not have a default load action.
You can choose from Show Inheritance Graph, Show Include File Graph, or None.

Use the Double Click Actions section to change the double-click action of the
objects in the Graph window. By default, the double-click actions for all
objects is to edit the object's definition. Note that the Browser is able to
detect whether an action is available for a given object, and will disable that
action on the corresponding PopUp menu. Thus, if you have selected a default
action which is not available for a particular object, the Browser will provide
you with a message relating this fact. Note that the double-click action for
objects in the List window are set independently from the settings made in the
Graph window.

Use the OK PushButton to accept the default changes. These settings will be
saved to the Browser profile (ibrs.ini) when you exit the Browser.

Use the Cancel PushButton to cancel the changes you have made. Use the Default
PushButton to reset to the default Browser settings for Graph windows.


ΓòÉΓòÉΓòÉ 4.5.2. Colors Page Help ΓòÉΓòÉΓòÉ

Use the Colors page to change the colors used by the Graph window. The Graph
window displays each type of program element as a different color and each
relationship as a different colored arc. The colors are set independently from
the colors used by the List window. You can also change the shape of node and
style of arc using the Graph Window Settings NoteBook Styles page.

When you invoke an action to create a graph, the object you used to launch the
action is highlighted in the Graph window in red, by default.

Making a color change affects all open Graph windows and all subsequently
opened Graph windows. The new defaults are saved to the Browser profile
(ibrs.ini) when you exit from the Browser.

On the left is a scrollable list of items for which you can set default colors.
On the upper right is the color palette containing 16 colors to choose from. On
the bottom right side is an Example Area that previews the color selection you
are currently editing.

To change an object's color:

  1. Select the object from the scrollable list.
  2. Click on a color from the 16 available colors. Your change appears in the
     Example Area.
  3. Select the OK PushButton if you want to apply your color changes to the
     Graph Window, or select the Cancel PushButton if you want to exit without
     making any changes.

 The Default PushButton restores the default colors used by the Browser Graph
 windows. By default, the color settings are:

 Object                   Color
 Class                     Cyan
 SOM Class                Dark Green
 SOM Metaclass            Light Green
 Function                 Blue
 File                     Red
 Background               White
 Action Status Bar Foreground Blue
 Action Status Bar Background White
 Selection Hilight        Red
 Public Inheritance       Black
 Protected Inheritance    Red
 Private Inheritance      Blue
 Function and File Arrows Black


ΓòÉΓòÉΓòÉ 4.5.3. Styles Page Help ΓòÉΓòÉΓòÉ

Use the Styles page to change the shape of the nodes and arcs displayed in the
Graph window:

  1. Select Graph Window... from the Options PullDown on the Graph window.
  2. Select the Styles tab on the Graph Window Settings notebook.
  3. Select the object/relationship from the Object Shape/Line Style ListBox.
  4. Select a shape/line type.
  5. Select OK to apply the changes to the Graph window, or select Cancel to
     exit without making changes.

 These changes will be saved to the ibrs.ini profile when you exit the Browser.

 The Default PushButton restores the Browser defaults for node shape and line
 style.


ΓòÉΓòÉΓòÉ 4.5.4. Bitmap Page Help ΓòÉΓòÉΓòÉ

You can save a graph displayed the Graph window to a bitmap file. Use the Graph
Window Settings NoteBook Bitmap page to specify the dimensions of the bitmap to
be saved. Enter the width and height of the bitmap that you want to save.

This size is used when you are saving an entire graph or a region of a graph,
or when you are copying an entire graph or a region of a graph to the
clipboard.

Note:   If you specify improper values for the width and height of the bitmap,
        the output may not be the desired affect. For example, if the area to
        be saved or copied is a square and the values set specify a rectangular
        shape, then the image saved or copied will be stretched to fit the
        rectangle.


ΓòÉΓòÉΓòÉ <hidden> File Dialogs Help ΓòÉΓòÉΓòÉ

The File Dialog is used by the Browser to load and merge .PDB, .DLL, .EXE,
.LIB, .PDD, .PDE, and .PDL files. Also, this dialog is used to save graphs,
lists and Browser database files.


ΓòÉΓòÉΓòÉ 4.6. Load Database Dialog Help ΓòÉΓòÉΓòÉ

The Load Database dialog is used to load your program's information into the
Browser. You can load the following types of files into a Browser session:

     .PDB  Browser database file created using the compiler option /Fb and the
           linker option /BROWSER.
     .LIB  Library file
     .EXE  Executable
     .DLL  Dynamic link library
     .PDL  Browser database file created from a loaded .LIB file.
     .PDE  Browser database file created from a loaded .EXE file
     .PDD  Browser database file created from a loaded .DLL file.

 To load a file:

  1. Select Load... from the File PullDown menu to start the Load Database
     dialog.
  2. Change the filename extension, if appropriate, in the Open Filename:
     TextEntry field.
  3. Select the drive you want to load from using the Drive: DropDown list.
  4. Select a directory on that drive from the Directory: ListBox.
  5. Select the filename from the File: ListBox. Note that you can load more
     than one .PDB file at a time by making multiple .PDB selections in this
     ListBox. You cannot do a multiple load of any other file type.
  6. Select the Load PushButton to load the information into the Browser.

 Note:   You can bypass these steps if you know the name and location of the
         file you wish to load. Enter the path name and file name into the Open
         Filename: TextEntry field.

 You can also quickly load the libraries that make up the IBM VisualAge for C++
 Open Class Library by using the Load > Cascade menu from the File PullDown
 menu. In addition, you can add your own files to this Cascade menu.

 When you select the Load PushButton, a Progress dialog is displayed to show
 you the amount of information that has been loaded by the Browser.

 You can load more than one program into the Browser at a time using the merge
 facility.


ΓòÉΓòÉΓòÉ 4.7. Merge Database Dialog Help ΓòÉΓòÉΓòÉ

When you browse a target program (an .EXE, .DLL, or .LIB), you will only see
those classes, functions, and files that were actually used in the program.
You will not see related objects. For example, assume that you have written a
small program using the IBM User Interface class library, and it contains an
IFrameWindow, a Menu bar, and some static text. The small program will only
reference the classes, functions, and files of the IFrameWindow, IMenuBar, and
IStaticText with their parent classes. If you want to add some PushButtons and
a bitmap onto your window, you can see these classes by merging the User
Interface Class Library data with your small program.

Also, many programs are written as an .EXE and one or more .DLLs. If you browse
the .EXE, then you only see the data from that .EXE. You can merge in the data
from the .DLL(s) and see the whole program's information.

To merge files:

  1. Select Merge... from the File PullDown menu to start the Merge Database
     dialog.
  2. Change the filename extension, if appropriate, in the Open Filename:
     TextEntry field.
  3. Select the drive you want to load from using the Drive: DropDown list.
  4. Select a directory on that drive from the Directory: ListBox.
  5. Select the filename from the File: ListBox. Note that you can merge more
     than one .PDB file at a time by making multiple .PDB selections in this
     ListBox. You cannot do a multiple merge of any other file type in this
     manner. To merge multiple files other than .PDBs, you must merge the files
     individually.
  6. Select the Merge PushButton to merge the information into the current
     Browser session.

 Note:   You can bypass these steps if you know the name and location of the
         file you wish to merge. Enter the path name and file name into the
         Open Filename: TextEntry field.

 You can merge the following file types: .DLL, .EXE, .LIB, .PDD, .PDE, .PDL,
 and .PDB. If you merge more than one .PDB file, this is analogous to grouping
 a set of .OBJ files together into a single .LIB file, so the saved file
 version in this case is a .PDL file.

 You can also quickly merge a library from the IBM VisualAge for C++ Open Class
 Library by using the Merge > Cascade menu from the File PullDown menu. In
 addition, you can add your own files to the Merge > Cascade menu.

 When you select the Merge PushButton, a Progress dialog is displayed to show
 you the amount of information that has been merged into the current Browser
 database.

 Note:   If you try to merge a file into the Browser database that conflicts
         with some of the information that is already loaded into the Browser,
         a message will appear to inform you. The file will not be loaded into
         the Browser database.


ΓòÉΓòÉΓòÉ 4.8. Save As Dialog Help ΓòÉΓòÉΓòÉ

To save a graph to a bitmap file or a list to an ASCII file:

  1. Select Save Graph As... or Save List As... from the File PullDown menu to
     start the dialog.
  2. Select the drive that you want to save the file to using the Drive:
     DropDown list.
  3. Select a directory on that drive from the Directory: ListBox.
  4. Enter the name of the file that you want to save the graph or list to into
     the Save as Filename: TextEntry field.
  5. Select the OK PushButton to save the information to selected drive and
     directory.

 Note:   You can bypass these steps if you know the name and location of the
         file you wish to save. Enter the path name and file name into the Save
         as Filename: TextEntry field.

 When you load more than one .PDB file, or merge files together, the Browser
 will prompt you for a name to call the Browser database file using the Save
 Database As dialog. Follow steps 2-5 above.


ΓòÉΓòÉΓòÉ 4.9. Browser Print Dialog Help ΓòÉΓòÉΓòÉ

Use the Browser Print dialog to print your List and Graph window contents. Note
that the name of the dialog reflects the print action that you want to perform
(e.g. Print - <print option>).

For a list, the printer uses as many pages as required to print the list, so
the Number of pages TextEntry field is disabled. As well, this TextEntry field
is disabled when you choose to print One Page..., Client..., or Zone... from
the Print > Cascade menu on the Graph window.

If you choose to print Multiple Pages... from the Print > Cascade menu on the
Graph window, you can select the layout of the pages to be printed by entering
the number of horizontal and vertical pages to print. The Graph window zooms
out to its maximum size, and the page layout is indicated by black rectangular
boxes on the graph. Each rectangular area is a page to be printed. Change the
horizontal and vertical page numbers until the page layout is to your liking,
and select the Apply PushButton to accept the new page layout.

Select the Print PushButton to print the current list or graph. Once the graph
is finished printing, the grid is cleared and the graph is restored to its
previous zoom setting. Select the Cancel PushButton to quit the dialog without
printing.

Select the Print Setup... PushButton to change the printer properties and page
setup. Select the Fonts... PushButton to change the font used when printing.
The Font dialog will be loaded.


ΓòÉΓòÉΓòÉ 4.9.1. Print Setup Dialog Help ΓòÉΓòÉΓòÉ

The Print Setup dialog is used to select the printer that you want to print to,
change the job properties of the print queue, and change the page setup.

To select a printer, choose a printer name from the Select Printer ListBox.
Select the OK PushButton to accept the choice of printer or Cancel to quit the
dialog without changing the printer selection.

To change the job properties of the print queue, select the Job Properties...
PushButton. These settings are saved to the Browser profile (ibrs.ini) when you
exit the Browser, and will be used for every print job to that printer.

To change the page setup, select the Page Setup... PushButton. This will launch
the Page Setup dialog.


ΓòÉΓòÉΓòÉ 4.9.2. Print Page Setup Dialog Help ΓòÉΓòÉΓòÉ

Use the Page Setup dialog to change the type of paper used and to set the
margins for printing on that paper.

Select a paper size from the Form name ListBox. Enter the margins that you want
to use with this paper size. You can set the top, bottom, left and right
margins. Margin settings are measured in inches.

Select OK to accept the changes or Cancel to close the dialog without making
changes.

Note:   The system may change the margin settings to either the minimum or
        maximum values if you have attempted to set an invalid value. For
        example, some printers may not support a margin less than a Γò¥ of an
        inch. So, if you try to set it to zero inches, the margin values will
        be automatically reset to a Γò¥ of an inch.


ΓòÉΓòÉΓòÉ 4.10. Find Dialog Help ΓòÉΓòÉΓòÉ

Use the Find dialog to locate text in the current window starting from the
currently selected object. Enter a text string into the Find TextEntry field or
use the to select from the last 10 text entries made.

Use the Find PushButton to initiate the search and close the Find dialog. Use
the Apply PushButton to initiate the search and keep the Find dialog open. Use
the Cancel PushButton to quit the dialog without performing the search.

If a match is found, the located text is brought into the view of the window
and the text is highlighted. If no matches are found, a Message Box appears to
let you know.

 o You can perform wildcard finds using:

    - An asterisk (*) to match any number of characters, and
    - A question mark (?) to match one character.

 o Use the Case Sensitive CheckBox to perform case dependent searches.

 o Use the Wrap Around CheckBox to search the entire contents of the current
   window. The message "Wrapped" appears in the Information Bar when the find
   is starting to search from the top of the list.

 You can find the next instance of the text by either selecting Find Next from
 the Edit PullDown or use the Ctrl+N keys. Note that you can also use the Apply
 PushButton to find the next instance.


ΓòÉΓòÉΓòÉ 4.11. Search Dialog Help ΓòÉΓòÉΓòÉ

You can use the Search dialog to search the proper names of objects. Enter the
text string that you want to search for into the Search TextEntry field. You
can also use the to access the last 10 searches performed.

Select the Search PushButton to perform the search query and close the Search
dialog. Select the Apply PushButton to perform the search query and keep the
Search dialog available. Select Cancel to end the Search dialog without
performing a query.

All program object names that match the search string will be listed in the
List window. Note that the return types and arguments are not searched. If no
matches are found, a Message Box appears to let you know.

 o You can perform wildcard searches using the following wildcards:

    - A question mark (?) to signify specific character locations, and
    - An asterisk (*) to signify any number of character locations.

 o Use the Case Sensitive CheckBox to perform case dependent searches.

 o Use the Exact Match CheckBox when you know the exact name of the object you
   want to locate. Note that you cannot use wildcards in conjunction with the
   Exact Match facility. The wildcard is treated as part of the actual search
   string.

 An example using non-exact match:

 o Enter foobar and deselect the Exact Match CheckBox.
 o Results: foobar and realfoobar.

 An example using exact match:

 o Enter foobar and select the Exact Match CheckBox.
 o Results: foobar
   But not: realfoobar.


ΓòÉΓòÉΓòÉ 4.12. History Window Help ΓòÉΓòÉΓòÉ

The History window can be used to redo previously performed object-action
pairs. This is useful if you replaced a particular List and Graph window
contents and no longer have direct access to the object.

The History window displays the last 40 unique object-action pairs that you
have performed during your current session. The object is listed on the left
side of the window and the action is displayed on the right side. Double-click
on any object-action pair to invoke it, or select the OK PushButton. Select
Apply if you want to invoke the object-action pair and keep the History window
open.

Invoking the object-action pair in the History window actually makes the
Browser re-calculate all the information again. If the object-action pair that
you want to invoke is listed at the top of the History window, you should use
the Previous menu item from the Actions PullDown menu, or the F6 key to
initiate this command. The Browser does not have to re-calculate the last
object-action pair performed, for the results are stored in a buffer.

When you perform a load, merge, or refresh action, the contents of the History
window are checked to see that the object in each object-action pair is still
valid. If it is not valid, it is removed from the History window.

Select the Cancel PushButton to close the dialog without performing an
object-action pair.


ΓòÉΓòÉΓòÉ 4.13. Font Dialogs Help ΓòÉΓòÉΓòÉ

Use the Font dialog to select the font type, size, style and emphasis. Note
that this dialog is called List Font when you want to change the font used in
the List window or the List Area of the Graph window, and it is called Node
Font when you want to change the font used in the nodes of the Graph window.

Note:   If you are using the Printer Font dialog, this only changes the font
        when you are printing. It does not change any of the fonts displayed in
        the windows.

 As you make selections, the Sample area of the dialog changes to give you a
 preview of what the font definition you have chosen will look like.

 Use the OK PushButton to accept the font changes. The new font settings will
 be saved to the Browser profile (ibrs.ini) when you close the Browser. Use the
 Reset PushButton to reset the dialog selections to the last used font
 definition. Use the Cancel PushButton to close the dialog without making any
 font changes.

 You can change fonts for the List window text, the List window Action Status
 Bar, the Graph window Graph Area and List Area, and the Graph window Action
 Status Bar.

 To change the List window text:

 o Select Fonts... from the List window Options PullDown menu.

 To change the List window Action Status Bar text:

  1. Select List Window... from the Options PullDown menu to get the List
     Window Settings NoteBook.
  2. Select the Settings tab.
  3. Choose the Select... PushButton.

 To change the Graph window Graph Area text:

 o Select Node Fonts... from the Graph window Options PullDown menu.

 To change the Graph window List Area text:

 o Select List Fonts... from the Graph window Options PullDown menu.

 To change the Graph window Action Status Bar text:

  1. Select Graph Window... from the Options PullDown menu to get the Graph
     Window Settings NoteBook.
  2. Select the Settings tab.
  3. Choose the Select... PushButton.


ΓòÉΓòÉΓòÉ 4.14. Browser Files Dialog Help ΓòÉΓòÉΓòÉ

The Browser Files dialog appears when the file you tried to load or merge into
the Browser is out-of-date. A list of all the files that are out-of-date or not
found are listed in the Files ListBox. The Current Search Paths is listed to
show you where the Browser is looking for the files. If this search path is
incorrect, use the Change Path... PushButton to launch the Paths dialog where
you can change the current path settings.

If the QuickBrowse files which could not be loaded CheckBox is selected, the
Browser will use the QuickBrowse facility to quickly parse the files.

Select the Load PushButton to start loading the data.

Note:   A QuickBrowse dialog will appear if the target file contains files that
        were built outside of the scope of the project. The files listed in
        this dialog will be ignored.

 The following is a sample of this dialog:


ΓòÉΓòÉΓòÉ 4.14.1. QuickBrowse Dialog Help ΓòÉΓòÉΓòÉ

The QuickBrowse dialog lists the names of files that the Browser could not
build. Select Continue to load information into the Browser that could be
QuickBrowsed. Select Cancel to stop loading information into the Browser.

The following is a sample of this dialog:


ΓòÉΓòÉΓòÉ 4.15. Profile Dialog Help ΓòÉΓòÉΓòÉ

The Profile dialog occurs when you start the Browser for the first time. You
are prompted for a directory to save the Browser profile (ibrs.ini). The
default location is the directory where the operating system is installed. If
you want to change this, enter the new directory path name into the TextEntry
field. Select OK to continue starting the Browser.

If at a later time you want to change the directory where the Browser profile
is stored, use the Browser Settings NoteBook Paths page.

The following is a sample of this dialog:


ΓòÉΓòÉΓòÉ 4.16. Choose Object Dialog Help ΓòÉΓòÉΓòÉ

The Choose Object dialog may appear when you launch a  Browser action from the
Browse Cascade menu on the Project PullDown menu in the Debugger.

The Browser may find more than one match for the selected item. The dialog has
a list of all the matches to the selected item. Choose the item you are
interested in from the list and select OK to perform the Browser action on that
item and close this dialog or, select Apply to perform the Browser action and
keep the dialog open.

The following is a sample of this dialog:


ΓòÉΓòÉΓòÉ 4.17. New User Dialog Help ΓòÉΓòÉΓòÉ

The New User Help dialog outlines the key features of the Browser. This dialog
appears when you start up the Browser and have not disabled this feature.

You can disable this dialog by deselecting the Show New User Help On Startup
CheckBox or by selecting an appropriate level of help from the Browser Settings
NoteBook Help Level page which you can invoke from any Options PullDown menu.

If you have disabled this dialog, you can enable it by selecting the New User
level of help from the Browser Settings NoteBook Help Level page.


ΓòÉΓòÉΓòÉ 4.18. Overview Window Help ΓòÉΓòÉΓòÉ

The Overview window shows the entire graph on a small scale. The grey shaded
area indicates the current view of the Graph Area in the Graph window. You can
move this area around or resize it. Any changes you make to the size or
position of this grey area is automatically reflected in the Graph window.

Use  and to size the view of the graph. The result is the same as if you had
used the Slider on the left side of the Graph window. Use the four-way
cross-arrow to move the grey area around. The result is the same as if you had
use the scroll bars around the Graph Area of the Graph window.


ΓòÉΓòÉΓòÉ 4.19. Progress Dialog Help ΓòÉΓòÉΓòÉ

The Progress dialog appears when you load or merge a file into the Browser, and
when you exit the Browser. When loading or merging, the dialog indicates how
much more information needs to be loaded. When you exit the Browser, the dialog
indicates how much more information needs to be saved to the Browser database
file for the currently loaded program.

The following diagram shows the load progress of the USERINTF.PDL file, which
is shipped with the Browser.

The following is a sample of this dialog:


ΓòÉΓòÉΓòÉ 5. Browser PullDown Menus ΓòÉΓòÉΓòÉ

The Browser List and Graph windows each have a PullDown menu bar.

The common PullDown menus are:

    File PullDown Menu
    Edit PullDown Menu
    Actions PullDown Menu
    Options PullDown Menu
    Windows PullDown Menu
    Project PullDown Menu
    Help PullDown Menu

 The List window has one unique PullDown menu: Order PullDown Menu

 The Graph window also has one unique PullDown menu: View PullDown Menu


ΓòÉΓòÉΓòÉ 5.1. File Pulldown Menu ΓòÉΓòÉΓòÉ

Use the File PullDown menu to:

    Load program files or Browser database files
    Merge program files or Browser database files
    Refresh the currently loaded Browser database
    Save the contents of the current window
    Print the contents of the current window
    Open a new blank window
    Create a copy of the current window
    Exit the Browser


ΓòÉΓòÉΓòÉ 5.1.1. Load > ΓòÉΓòÉΓòÉ

The Load > Cascade menu item allows you to load your programs (.DLL, .EXE,
.LIB) or Browser database files (.PDB, .PDD, .PDE, .PDL), or you can load the
IBM VisualAge for C++ Open Class Library classes:

    Load...
    User Interface Classes
    Collection Classes
    I/O Stream Classes
    Complex Math Classes
    Database Access Classes
    Application Support Classes
    OLE Frameworks Classes

 The Load > Cascade menu will also include any items that you have added. See
 User Added Menu Items for more information.

 See the Load Database dialog for more information on loading files into the
 Browser.


ΓòÉΓòÉΓòÉ 5.1.1.1. Load... ΓòÉΓòÉΓòÉ

The Load... menu item launches the Load Database dialog. You can load the name
of a program file with the extension .EXE, .LIB, or .DLL, or a Browser database
file with the extension .PDE, .PDL, .PDD, or .PDB.


ΓòÉΓòÉΓòÉ 5.1.1.2. User Interface Classes ΓòÉΓòÉΓòÉ

The User Interface Classes menu item loads the Browser information for the User
Interface Classes which make up part of the IBM VisualAge for C++ Open Class
Library.


ΓòÉΓòÉΓòÉ 5.1.1.3. Collection Classes ΓòÉΓòÉΓòÉ

The Collection Classes menu item loads the Browser information for the
Collection Classes which make up part of the IBM VisualAge for C++ Open Class
Library.


ΓòÉΓòÉΓòÉ 5.1.1.4. I/O Stream Classes ΓòÉΓòÉΓòÉ

The I/O Stream Classes menu item loads the Browser information for the external
interfaces to the I/O Stream Classes which make up part of the IBM VisualAge
for C++ Open Class Library.


ΓòÉΓòÉΓòÉ 5.1.1.5. Complex Math Classes ΓòÉΓòÉΓòÉ

The Complex Math Classes menu item loads the Browser information for the
external interfaces to the Complex Mathematics Classes which make up part of
the IBM VisualAge for C++ Open Class Library.


ΓòÉΓòÉΓòÉ 5.1.1.6. Database Access Classes ΓòÉΓòÉΓòÉ

The Database Access Classes menu item loads the Browser information for the
external interfaces to the Database Access Classes which make up part of the
IBM VisualAge for C++ Open Class Library .


ΓòÉΓòÉΓòÉ 5.1.1.7. Application Support Classes ΓòÉΓòÉΓòÉ

The Application Support Classes menu item loads the Browser information for the
external interfaces to the Application Support Classes which make up part of
the IBM VisualAge for C++ Open Class Library .


ΓòÉΓòÉΓòÉ 5.1.1.8. OLE Frameworks Classes ΓòÉΓòÉΓòÉ

The OLE Frameworks Classes menu item loads the Browser information for the
external interfaces to the OLE Frameworks Classes which make up part of the IBM
VisualAge for C++ Open Class Library .


ΓòÉΓòÉΓòÉ 5.1.1.9. User Added Menu Items ΓòÉΓòÉΓòÉ

You can add your own files to the Load > and Merge > Cascade menus by:

  1. Creating an ASCII file called brsmenu.txt and place it in a directory in
     your DPATH.
  2. Using the following format:
     Menu Name"path_name\file_name

     Where Menu Name is the name you want to have appear on the Load > and
     Merge > Cascade menus, and path_name\file_name is the path name and file
     name of the file to be loaded or merged. You can have spaces in the Menu
     Name. Be sure to separate the Menu Name from the path_name\file_name with
     a double quote (").

     Note:   You must have a blank line at the end of the brsmenu.txt file.


  3. You can add a maximum of six files.

 The new menu items will be added to the Load > and Merge > Cascade menus the
 next time you start the Browser. Note that you have to restart the Browser if
 you want changes to this file to take effect.

 See the Load Database dialog and the Merge Database dialog for more
 information on loading and merging files into the Browser.


ΓòÉΓòÉΓòÉ 5.1.2. Merge > ΓòÉΓòÉΓòÉ

The Merge facility allows you to see your program extended with additional
controls or features from another program or library. For example, you may want
to add User Interface Class Library features to your program. Using the Merge
facility, you can browse this class library without losing any information
about your program.

The Merge > Cascade has the following options:

    Merge...
    User Interface Classes
    Collection Classes
    I/O Stream Classes
    Complex Math Classes
    Database Access Classes
    Application Support Classes
    OLE Frameworks Classes

 The Merge > Cascade menu will also include any items that you have added. See
 User Added Menu Items for more information.

 See the Merge Database dialog for more information on merging files into the
 Browser.


ΓòÉΓòÉΓòÉ 5.1.2.1. Merge... ΓòÉΓòÉΓòÉ

The Merge facility allows you to merge a specified Browser database file or
library into the current Browser database. The Merge... menu item launches the
Merge Database dialog.


ΓòÉΓòÉΓòÉ 5.1.2.2. User Interface Classes ΓòÉΓòÉΓòÉ

The User Interface Classes menu item merges the Browser information for the
external interfaces to the User Interface Classes which make up part of the IBM
VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.3. Collection Classes ΓòÉΓòÉΓòÉ

The Collection Classes menu item merges the Browser information for the
external interfaces to the Collection Classes which make up part of the IBM
VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.4. Complex Math Classes ΓòÉΓòÉΓòÉ

The Complex Math Classes menu item merges the Browser information for the
external interfaces to the Complex Mathematics Classes which make up part of
the IBM VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.5. I/O Stream Classes ΓòÉΓòÉΓòÉ

The I/O Stream Classes menu item merges the Browser information for the
external interfaces to the I/O Stream Classes which make up part of the IBM
VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.6. Database Access Classes ΓòÉΓòÉΓòÉ

The Database Access Classes menu item merges the Browser information for the
external interfaces to the Database Access Classes which make up part of the
IBM VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.7. Application Support Classes ΓòÉΓòÉΓòÉ

The Application Support Classes menu item merges the Browser information for
the external interfaces to the Application Support Classes which make up part
of the IBM VisualAge for C++ Open Class Library into the current Browser
database.


ΓòÉΓòÉΓòÉ 5.1.2.8. OLE Frameworks Classes ΓòÉΓòÉΓòÉ

The OLE Frameworks Classes menu item merges the Browser information for the
external interfaces to the OLE Frameworks Classes which make up part of the IBM
VisualAge for C++ Open Class Library into the current Browser database.


ΓòÉΓòÉΓòÉ 5.1.2.9. User Added Menu Items ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 5.1.3. Refresh ΓòÉΓòÉΓòÉ

The Refresh menu item reloads your program with the best source of data
possible. If you have made modifications to your source code, have done a
build, and you are generating Browser information in your compiler options, the
Refresh facility reloads the necessary information from the .PDB files
generated.

If you have modified your source code, but have not regenerated the Browser
information, the Browser Files dialog appears. You can choose to QuickBrowse
your source by checking the QuickBrowse files which could not be loaded
CheckBox and select the Load PushButton. The QuickBrowse facility is fast, but
there may be a loss of information provided for your program. The benefit is
that you do not have to wait for a lengthy recompile of your source to browse
the declarations in your programs.


ΓòÉΓòÉΓòÉ 5.1.4. Save Graph As... ΓòÉΓòÉΓòÉ

The Save Graph As... menu item allows you to save the current graph to a bitmap
format. You can then import this bitmap into your own documents.

For a selected area, only the selected portion will be saved.

Note:   The bitmap dimensions specified in the Browser Settings NoteBook Paths
        page will be used to size the bitmap when it is saved.

 For more information, see the Save As dialog.


ΓòÉΓòÉΓòÉ 5.1.5. Save List As... ΓòÉΓòÉΓòÉ

The Save List As... menu item allows you to save the current list to ASCII
format. You can then edit the file.

For more information, see the Save As dialog.


ΓòÉΓòÉΓòÉ 5.1.6. Print ΓòÉΓòÉΓòÉ

From the List window, you can print the current list to a printer.

From the Graph window, you can perform the following print options:

    Print One Page...
    Print Client...
    Print Zone...
    Print Multiple Pages...

    See the Browser Print dialog for more information on printing.


ΓòÉΓòÉΓòÉ 5.1.6.1. One Page... ΓòÉΓòÉΓòÉ

The One Page... menu item prints the entire graph on one page of paper. If the
graph is complex, then it is likely that the details of the resultant single
page output will be unreadable, however the structure of the graph can still be
useful. If you need to read the nodes, then either zoom in to a legible level
of detail and use the Client... option, or print a single section using the
Zone... menu item, or print the entire graph at a definable level of detail
using the Multiple Pages... menu item.

See the Browser Print dialog for more information on printing.


ΓòÉΓòÉΓòÉ 5.1.6.2. Client... ΓòÉΓòÉΓòÉ

The Client... menu item prints the currently viewed section of the graph on one
page of paper.

See the Browser Print dialog for more information on printing.


ΓòÉΓòÉΓòÉ 5.1.6.3. Zone... ΓòÉΓòÉΓòÉ

Prints the section of the graph that you have marked.

See the Browser Print dialog for more information on printing.


ΓòÉΓòÉΓòÉ 5.1.6.4. Multiple Pages... ΓòÉΓòÉΓòÉ

The Multiple Pages... menu item will print the entire graph on several pages of
paper. The graph will be printed at full zoom across as many pages as you
specify. This option is recommended for very large graphs.

See the Browser Print dialog for more information on printing.


ΓòÉΓòÉΓòÉ 5.1.7. New Window ΓòÉΓòÉΓòÉ

The New Window menu item creates another List window if launched from a List
window, or another Graph window if launched from a Graph window. The new window
will be blank.

You can have a maximum of four List windows and four Graph windows open at any
time.


ΓòÉΓòÉΓòÉ 5.1.8. Copy Window ΓòÉΓòÉΓòÉ

The Copy Window menu item copies the current List or Graph window contents and
puts them into a new List or Graph window.

You can have a maximum of four List windows and four Graph windows open at any
time.


ΓòÉΓòÉΓòÉ 5.1.9. Exit Browser ΓòÉΓòÉΓòÉ

The Exit Browser menu item ends your current Browser session. All List and
Graph windows will be closed.

If you have chosen the Confirm on Exit CheckBox on the Browser Settings
NoteBook Help Level page, then you will be prompted to confirm that you want to
exit the Browser. To remove this confirmation, uncheck the CheckBox.

If you browsed an .EXE, .DLL, or .LIB file for the first time since it was
built or loaded a .PDB file, the Browser will save away the contents of its
current Browser database to disk, so that the next time you browse the same
file, it will load much quicker. Note that if you have performed a merge, or
loaded multiple .PDB files, then the Browser will prompt you as to whether you
want to save the current contents of the Browser database. This is because the
Browser cannot determine what file name to save the contents to. Select Yes to
display the Save Database As dialog. Select No to exit the Browser without
saving the current Browser database.


ΓòÉΓòÉΓòÉ 5.2. Edit Pulldown Menu ΓòÉΓòÉΓòÉ

The Edit PullDown menu allows you to:

    Find text in the current window
    Find next occurrence
    Copy currently selected object to the clipboard
    Copy All text to the clipboard to the clipboard


ΓòÉΓòÉΓòÉ 5.2.1. Find... ΓòÉΓòÉΓòÉ

The Find... menu item launches the Find dialog. You can search the objects in
the current window for the first instance matching the text string that you
entered into the Find dialog.


ΓòÉΓòÉΓòÉ 5.2.2. Find Next ΓòÉΓòÉΓòÉ

The Find Next menu item searches the objects of the current window for the next
instance of the text string that was last entered into the Find dialog. It does
not search the entire Browser database. Note that the search begins from the
current selection position in the window.


ΓòÉΓòÉΓòÉ 5.2.3. Copy ΓòÉΓòÉΓòÉ

The Copy menu item copies the currently selected object to the clipboard. You
can paste this line into any editor.

Note:   This menu item is only available in the List window.


ΓòÉΓòÉΓòÉ 5.2.4. Copy All ΓòÉΓòÉΓòÉ

The Copy All menu item copies the entire contents of the List window or the
graph in the Graph window to the clipboard.

For graphs:

  The copied image is sized according to the bitmap settings specified in the
  Browser Settings NoteBook Bitmap page.


ΓòÉΓòÉΓòÉ 5.3. View Pulldown Menu ΓòÉΓòÉΓòÉ

The View PullDown menu only pertains to the Graph window. It allows you to:

    o See an overview of the entire graph
    o Zoom in on the graph
    o Zoom out on the graph
    o  Maximum zoom in
    o Maximum zoom out
    o Center the currently selected node in the Graph Area
    o Display relationships vertically
    o Display relationships horizontally
    o Change the weighting in the layout of the graph


ΓòÉΓòÉΓòÉ 5.3.1. Overview... ΓòÉΓòÉΓòÉ

The Overview... menu item launches an Overview window which displays the graph
on a small scale so that you can see the entire structure of the graph.


ΓòÉΓòÉΓòÉ 5.3.2. Zoom In ΓòÉΓòÉΓòÉ

The Zoom in menu item will increase the magnification of the current graph by
one factor. One factor is approximately 10%.


ΓòÉΓòÉΓòÉ 5.3.3. Zoom Out ΓòÉΓòÉΓòÉ

The Zoom out menu item will decrease the magnification of the current graph by
one factor. One factor is approximately 10%.


ΓòÉΓòÉΓòÉ 5.3.4. Max Zoom In ΓòÉΓòÉΓòÉ

The Max Zoom in menu item will display the current graph at the maximum
magnification.


ΓòÉΓòÉΓòÉ 5.3.5. Max Zoom Out ΓòÉΓòÉΓòÉ

The Max Zoom out menu item will display the current graph at the minimum
magnification.


ΓòÉΓòÉΓòÉ 5.3.6. Center ΓòÉΓòÉΓòÉ

The Center menu item moves the currently selected node to the center of the
graph area.


ΓòÉΓòÉΓòÉ 5.3.7. Vertical ΓòÉΓòÉΓòÉ

The Vertical menu item draws the graph with a vertical orientation. That is,
the nodes are read from top to bottom.

Some graphs tend to be more understandable when the arcs are drawn vertically,
while others are more understandable with the arcs drawn horizontally. If you
find a graph hard to understand, try changing to the other orientation.


ΓòÉΓòÉΓòÉ 5.3.8. Horizontal ΓòÉΓòÉΓòÉ

The Horizontal menu item draws the graph with a horizontal orientation. That
is, the nodes are read from left to right.

Some graphs tend to be more understandable when the arcs are drawn vertically,
while others are more understandable with the arcs drawn horizontally. If you
find a graph hard to understand, try changing to the other orientation.


ΓòÉΓòÉΓòÉ 5.3.9. Weighting > ΓòÉΓòÉΓòÉ

Some graphs tend to be more understandable when the graph is drawn with all
root nodes at an equal level, with all leaf nodes at an equal level, or with
most nodes grouped together in the middle. If you find a graph hard to
understand, try changing the weighting setting:

 o Top
 o Center
 o Bottom


ΓòÉΓòÉΓòÉ 5.3.9.1. Top ΓòÉΓòÉΓòÉ

The Top menu item organizes the nodes so that most of the nodes are at the top
or left of the graph depending whether you have chosen horizontal or vertical
alignment.


ΓòÉΓòÉΓòÉ 5.3.9.2. Center ΓòÉΓòÉΓòÉ

The Center menu item organizes the nodes so that most of the nodes are at the
center of the graph.


ΓòÉΓòÉΓòÉ 5.3.9.3. Bottom ΓòÉΓòÉΓòÉ

The Bottom menu item organizes the nodes so that most of the nodes are at the
bottom or right of the graph depending whether you have chosen horizontal or
vertical alignment.


ΓòÉΓòÉΓòÉ 5.4. Actions Pulldown Menu ΓòÉΓòÉΓòÉ

The Actions PullDown provides you with the most common Browser actions that you
will perform on the entire Browser database.

    Go back to the previous object-action pair
    Search the Browser database
    Graph the inheritance relationships
    Graph the include file relationships
    List all classes in the Browser database
    List all files in the Browser database


ΓòÉΓòÉΓòÉ 5.4.1. Previous ΓòÉΓòÉΓòÉ

The Previous menu item returns to the last object-action pair performed in the
current window. If you are unsure what the last object-action pair was, use the
History window to see a list of the last 40 object-action pairs performed.


ΓòÉΓòÉΓòÉ 5.4.2. Search... ΓòÉΓòÉΓòÉ

The Search... menu item launches the Search Database dialog. You can search the
current Browser database for classes, functions, types, variables, and files.


ΓòÉΓòÉΓòÉ 5.4.3. Show Inheritance Graph ΓòÉΓòÉΓòÉ

The Show Inheritance Graph menu item displays the tree structure that
represents how all the defined classes in the entire Browser database are
related by inheritance. Note that classes that are declared but that are not
defined are not displayed. For large Browser databases, this could take a few
seconds to display the Graph window.


ΓòÉΓòÉΓòÉ 5.4.4. Show Include File Graph ΓòÉΓòÉΓòÉ

The Show Include File Graph menu item displays a tree structure that represents
how all the source files in the current Browser database are related by the C
preprocessor #include mechanism.


ΓòÉΓòÉΓòÉ 5.4.5. List All Classes ΓòÉΓòÉΓòÉ

The List All Classes menu item creates an alphabetical list of all the classes
declared in the Browser database. This is the default action when a file is
loaded into the List window.

You can change the default setting using the List Window Settings NoteBook
Settings page.


ΓòÉΓòÉΓòÉ 5.4.6. List All Files ΓòÉΓòÉΓòÉ

The List All Files menu item creates an alphabetical list of all the source
files used to create the currently loaded Browser database.

Note:   The file names listed for the IBM Open Class Library selections may
        have a different path name than is on your machine. However, the
        Browser searches the File Search Path defined in the Browser Settings
        NoteBook Paths page which includes your INCLUDE environment variable
        which was updated with the install directory of the VisualAge for C++
        libraries when you installed VisualAge for C++ on your machine.


ΓòÉΓòÉΓòÉ 5.5. Options Pulldown Menu ΓòÉΓòÉΓòÉ

From the Options PullDown menu you can define the various types of settings
used by the Browser:

    Change the fonts used
    Change the List window settings
    Change the Graph window settings
    Change the Browser settings.


ΓòÉΓòÉΓòÉ 5.5.1. Fonts... ΓòÉΓòÉΓòÉ

On the List window Options PullDown menu, the Fonts... menu item allows you to
change the text font used in the List Area of the List window.

On the Graph window Options PullDown menu, there are two font options to choose
from: Node Fonts... to change the text font used by the nodes in a graph and
List Fonts... to change the text font used by the List Area of the graph.


ΓòÉΓòÉΓòÉ 5.5.1.1. Node Fonts... ΓòÉΓòÉΓòÉ

The Node Fonts... menu item launches the Fonts dialog in order to change the
font used by the nodes in the graph.


ΓòÉΓòÉΓòÉ 5.5.1.2. List Fonts... ΓòÉΓòÉΓòÉ

The List Fonts... menu item launches the List Fonts dialog in order to change
the font used by the text in the List Area of the Graph window.


ΓòÉΓòÉΓòÉ 5.5.2. Graph Window... ΓòÉΓòÉΓòÉ

The Graph Window... menu item launches the Graph window Settings NoteBook. Use
this NoteBook to change the default load action, object double-click action,
colors, styles, and bitmap size.


ΓòÉΓòÉΓòÉ 5.5.3. List Window... ΓòÉΓòÉΓòÉ

The List Window... menu item launches the List window Settings NoteBook. Use
this NoteBook to change the default load action, object double-click action,
colors, and styles.


ΓòÉΓòÉΓòÉ 5.5.4. Browser... ΓòÉΓòÉΓòÉ

The Browser... menu item launches the Browser Settings NoteBook. Use this
NoteBook to change the search paths and help levels of the Browser.


ΓòÉΓòÉΓòÉ 5.6. Order Pulldown Menu ΓòÉΓòÉΓòÉ

The Order PullDown menu only pertains to the List window when it is a container
view that was produced using the List Members with Inheritance action. It
allows you to view the listed program elements in three different ways:

    By Class
    By Access
    By Type


ΓòÉΓòÉΓòÉ 5.6.1. Class ΓòÉΓòÉΓòÉ

The Class menu item reorders the current objects in the list. The base classes
are at the highest level. For example:

 Class 1
  Public
   Constructors/Destructors
   Functions
   Types
   Variables
  Protected
  Private
 Class 2

The Class order is the default order for the List window when displaying class
members.


ΓòÉΓòÉΓòÉ 5.6.2. Access ΓòÉΓòÉΓòÉ

The Access menu item reorders the current objects in the list with the access
method at the highest level. For example:

 Public
  Constructors/Destructors
  Functions
   Class 1
   Class 2
  Types
  Variables
 Protected
 Private


ΓòÉΓòÉΓòÉ 5.6.3. Type ΓòÉΓòÉΓòÉ

The Type menu item reorders the current objects in the list with the type of
object at the highest level. For example:

 Constructors/Destructors
 Functions
  Public
  Protected
   Class 1
   Class 2
  Private
 Types
 Variables


ΓòÉΓòÉΓòÉ 5.7. Windows Pulldown Menu ΓòÉΓòÉΓòÉ

The Windows PullDown menu shows you how many List and Graph windows you
currently have open, and allows you to select any of them to bring them into
focus.

    History...
    Graph 1
    Graph 2
    Graph 3
    Graph 4
    List 1
    List 2
    List 3
    List 4


ΓòÉΓòÉΓòÉ 5.7.1. History... ΓòÉΓòÉΓòÉ

The History... menu item launches the History window. It lists the last 40
object-action pairs performed. You can double-click on any object-action pair
to perform it again.


ΓòÉΓòÉΓòÉ 5.7.2. Graph 1 ΓòÉΓòÉΓòÉ

The Graph 1 menu item gives you quick access to the first Graph window that you
opened. If you do not have any Graph windows open, then this menu item will not
appear.


ΓòÉΓòÉΓòÉ 5.7.3. Graph 2 ΓòÉΓòÉΓòÉ

The Graph 2 menu item gives you quick access to the second Graph window that
you opened. If you do not have a second Graph window opened, then this menu
item will not appear.


ΓòÉΓòÉΓòÉ 5.7.4. Graph 3 ΓòÉΓòÉΓòÉ

The Graph 3 menu item gives you quick access to the third Graph window that you
opened. If you do not have a third Graph window opened, then this menu item
will not appear.


ΓòÉΓòÉΓòÉ 5.7.5. Graph 4 ΓòÉΓòÉΓòÉ

The Graph 4 menu item gives you quick access to the fourth Graph window that
you opened. If you do not have a fourth Graph window opened, then this menu
item will not appear.


ΓòÉΓòÉΓòÉ 5.7.6. List 1 ΓòÉΓòÉΓòÉ

The List 1 menu item gives you quick access to the first List window that you
opened. If you do not have any List windows open, then this menu item will not
appear.


ΓòÉΓòÉΓòÉ 5.7.7. List 2 ΓòÉΓòÉΓòÉ

The List 2 menu item gives you quick access to the second List window that you
opened. If you do not have a second List window opened, then this menu item
will not appear.


ΓòÉΓòÉΓòÉ 5.7.8. List 3 ΓòÉΓòÉΓòÉ

The List 3 menu item gives you quick access to the third List window that you
opened. If you do not have a third List window opened, then this menu item will
not appear.


ΓòÉΓòÉΓòÉ 5.7.9. List 4 ΓòÉΓòÉΓòÉ

The List 4 menu item gives you quick access to the fourth List window that you
opened. If you do not have a fourth List window opened, then this menu item
will not appear.


ΓòÉΓòÉΓòÉ 5.8. Project Pulldown Menu Help ΓòÉΓòÉΓòÉ

The Project PullDown menu gives you access to the IBM WorkFrame options and the
other VisualAge for C++ components.

For more information on IBM WorkFrame, see the IBM WorkFrame section in the
User's Guide.


ΓòÉΓòÉΓòÉ 5.9. Help Pulldown Menu Help ΓòÉΓòÉΓòÉ

The Help PullDown menu gives you access to the various kinds of help available:

    Help Index
    General Help
    Using Help
    How Do I...
    VisualAge for C++ Help Cascades
    Product Information


ΓòÉΓòÉΓòÉ 5.9.1. Help Index ΓòÉΓòÉΓòÉ

The Help Index menu item launches the index for the Browser online help.


ΓòÉΓòÉΓòÉ 5.9.2. General Help ΓòÉΓòÉΓòÉ

The General Help menu item launches the online help for the Browser. The panel
opened will either be the List window description or the Graph window
description, depending on which window you launched the action from. You can
select items on the Browser windows and press the F1 to get context sensitive
help on that particular item, or use the Table of Contents or Index to search
for the help that you need.


ΓòÉΓòÉΓòÉ 5.9.3. Using Help ΓòÉΓòÉΓòÉ

The Using Help menu item launches help information for using the Information
Presentation Facility (IPF).


ΓòÉΓòÉΓòÉ 5.9.4. How Do I... ΓòÉΓòÉΓòÉ

The How Do I... menu item launches the Browser: How Do I... information. It
provides step-by-step instructions on how to perform tasks using the Browser.

Click here to launch the Browser: How Do I... information.


ΓòÉΓòÉΓòÉ 5.9.5. VisualAge for C++ Help Menu Items ΓòÉΓòÉΓòÉ

The central portion of the Help PullDown menu is dedicated to all the online
documentation that is shipped with VisualAge for C++. Making a selection from
any of these Cascade menus launches the VisualAge for C++ documentation
associated with the menu item. You can find the same documentation in the
Information notebook found in the VisualAge for C++ Desktop folder.

The Cascade menus are organized as follows:

 At A Glance >
           Provides general information about VisualAge for C++, such as
           installing the product, a notebook that accesses the sample
           programs, and answers to frequently asked questions.

 Using VisualAge for C++ >
           Provides direct access to the individual sections of the User's
           Guide. For example, if you are using the Browser, you would look in
           the Browsing section for more information.

 How Do I... Selections >
           Provides access to the How Do I... information for each component of
           VisualAge for C++. Use How Do I... information to find out how to
           perform common tasks within VisualAge for C++.

 C/C++ >
           Provides access to the information that is specific to programming
           in C and C++.

 Class Libraries >
           Provides access to the VisualAge for C++ Open Class Library
           documentation.

 Visual Programming >
           Provides access to the information that is specific to creating your
           programs visually.

 IPF, and Editing >
           Provides access to the IPF and Editor references.

 SOM >
           Provides access to the information specific to SOM.

 Windows Programming
           Provides access to information about programming with the Win32
           Software Development Kit.


ΓòÉΓòÉΓòÉ 5.9.6. Product Information ΓòÉΓòÉΓòÉ

The Product Information menu item provides information about this release of
the Browser.


ΓòÉΓòÉΓòÉ 6. PopUp Menus ΓòÉΓòÉΓòÉ

Each of the objects displayed in a List or Graph window has an associated list
of actions that can be performed on that object:

    Class PopUp Menu
    Function PopUp Menu
    Variable PopUp Menu
    Type PopUp Menu
    File PopUp Menu
    Label PopUp Menu

 The List and Graph windows also have PopUp menus which allow you to perform
 window specific actions:

    List Window Background PopUp Menu
    Graph Window Background PopUp Menu
    Graph Zone PopUp Menu


ΓòÉΓòÉΓòÉ 6.1. Class PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on a class object.

    Edit Definition
    Show Documentation
    Graph All Base & Derived Classes
    Graph All Base Classes
    Graph All Derived Classes
    Graph Immediate Derived Classes
    List Members with Inheritance
    List Friends
    List Friendships
    List Implementing Files
    List Instantiations

 The following menu items appear on the menu if you have a List container view:

    Expand
    Collapse

 The following menu item appears on the menu if you are in a Graph window:

    Center


ΓòÉΓòÉΓòÉ 6.1.1. Edit Definition ΓòÉΓòÉΓòÉ

The Edit Definition menu item launches the VisualAge for C++ Editor, and loads
the file containing the definition of the currently selected class. By default,
the editor is positioned to the first line of the definition of this class.

Note that this menu item will be disabled if there is a forward declaration of
the class, but no definition. For example, the forward reference:

     class IWindow;

would cause IWindow to appear in the List window that results from the List All
Classes action on this class. However, if the complete declaration is not in
the Browser database, the Edit Definition action item will be disabled for this
class.


ΓòÉΓòÉΓòÉ 6.1.2. Show Documentation ΓòÉΓòÉΓòÉ

The Show Documentation menu item launches the help panel in the IBM VisualAge
for C++ Open Class Library documentation for the currently selected class.

Note that this function will only work with the VisualAge for C++ Open Class
Library classes. You can quickly access these classes through the Load> and
Merge> Cascade menus.


ΓòÉΓòÉΓòÉ 6.1.3. Graph All Base Classes ΓòÉΓòÉΓòÉ

The Graph All Base Classes menu item creates an inheritance graph of all the
base classes of the selected class. These include both direct and indirect base
classes.

Note that this menu item will be disabled if the selected class has no base
classes, or if the selected class has only been declared and not defined.


ΓòÉΓòÉΓòÉ 6.1.4. Graph All Base and Derived Classes ΓòÉΓòÉΓòÉ

The Graph All Base & Derived Classes menu item creates an inheritance graph of
all the base classes of the selected class, and all the classes that derive
from the selected class, in one relationship graph. These include both direct
and indirect base and derived classes.

Note that this menu will be disabled if there are no classes which derive from
the selected class, if the selected class has been declared but not defined, or
if the selected class has no base classes.


ΓòÉΓòÉΓòÉ 6.1.5. Graph All Derived Classes ΓòÉΓòÉΓòÉ

The Graph All Derived Classes menu item creates an inheritance graph of all the
classes that are derived from the selected class. These include both direct and
indirect derived classes.

Note that this menu item will be disabled if there are no classes which derive
from the selected class, or if the selected class has been declared but not
defined.


ΓòÉΓòÉΓòÉ 6.1.6. Graph Immediate Derived Classes ΓòÉΓòÉΓòÉ

The Graph Immediate Derived Classes menu item creates a Graph window which
displays one level of derived classes for this class.

Note that this menu item is disabled if there are no classes which derive from
the selected class, or if the selected class has been declared but not defined.


ΓòÉΓòÉΓòÉ 6.1.7. List Members With Inheritance ΓòÉΓòÉΓòÉ

The List Members with Inheritance menu item creates a List container view of
all the members for the selected classes and its base classes. The resultant
list is not sorted alphabetically as items in a List window generally are. The
classes are arranged in a depth first tree traversal of the classes inheritance
hierarchy.

Note that this menu item will be disabled if the selected class has been
declared but not defined.


ΓòÉΓòÉΓòÉ 6.1.8. List Instantiations ΓòÉΓòÉΓòÉ

The List Instantiations menu item creates a list of class template
instantiations for the selected template class.

Note that this menu item is disabled if the selected class is not a template
class, or if the selected class has been declared but not defined.

Note:   When you QuickBrowse your source files that contain class template
        instantiations, the instantiations will not be listed in the List All
        Classes, output. In fact, the instantiations will not exist in the
        Browser database. What you will find in the database is the correct
        name/type of the instantiation given as the type of the (member)
        variable that is an instance of that instantiation, given that
        QuickBrowse sees the declaration of the variable. Note that the List
        Instantiations action will always result in the No Results Found
        message, even though these template instantiations are found.


ΓòÉΓòÉΓòÉ 6.1.9. List Implementing Files ΓòÉΓòÉΓòÉ

The List Implementing Files menu item creates a list of files that contain
definitions for the class, and for any of the members of the class

Note:   The file names listed for the IBM Open Class Library selections may
        have a different path name than is on your machine. However, the
        Browser searches the File Search Path defined in the Browser Settings
        NoteBook Paths page which includes your INCLUDE environment variable
        which was updated with the install directory of the VisualAge for C++
        libraries when you installed VisualAge for C++ on your machine.

 Note that this menu item will be disabled if the selected class has been
 declared but not defined.


ΓòÉΓòÉΓòÉ 6.1.10. List Friends ΓòÉΓòÉΓòÉ

The List Friends menu item lists all the friends of the currently selected
class. A friend of a class is a function that has been granted access to the
private members of the class. A friend class obtains access to the private
members for all of its member functions. The result of this action is a list
container view with functions and classes as the two labels in the container.

Note that this menu item will be disabled if the class contains no friend
statements, or if the class has been declared but not defined.


ΓòÉΓòÉΓòÉ 6.1.11. List Friendships ΓòÉΓòÉΓòÉ

The List Friendships menu item lists all the friendships that have been granted
to the currently selected class. You can grant friendships to either a single
function or member function at a time, or to all the member functions of a
class at once. This action results in a list of all those classes that have
granted the selected class friendship.


ΓòÉΓòÉΓòÉ 6.1.12. Expand ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.1.13. Collapse ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.2. Function PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on a function object.

    Edit Definition
    Show Documentation
    Graph All Callers
    Graph All Callees
    Graph All Callers & Callees
    Graph Immediate Callers & Callees
    List Immediate Callers & Callees
    List Possible Exceptions Thrown
    List Overriding Derived Classes
    List Friendships
    List Instantiations
    List Members with Inheritance

 The following menu item appears on the menu if you are in a Graph window:

    Center


ΓòÉΓòÉΓòÉ 6.2.1. Edit Definition ΓòÉΓòÉΓòÉ

The Edit Definition menu item launches the VisualAge for C++ Editor, and loads
file containing the definition of the currently selected function. By default,
the editor is positioned to the first line of the definition of this function.

Note that this menu item will be disabled if the function has been declared but
not defined.


ΓòÉΓòÉΓòÉ 6.2.2. Show Documentation ΓòÉΓòÉΓòÉ

The Show Documentation menu item launches the help panel in the IBM VisualAge
for C++ Open Class Library documentation for the currently selected function.

Note that this function will only work with the VisualAge for C++ Open Class
Library classes. You can quickly access these classes through the Load> and
Merge> Cascade menus.


ΓòÉΓòÉΓòÉ 6.2.3. Graph All Callers ΓòÉΓòÉΓòÉ

The Graph All Callers menu item creates a graph of all the functions that call
the currently selected function. These include the functions which call the
selected function directly, or those functions that call it indirectly through
other functions.

Note that this menu item will be disabled if no functions call the selected
function, if the function has been declared but not defined, or if the source
files containing the function definitions has been handled by the QuickBrowse
feature of the Browser.


ΓòÉΓòÉΓòÉ 6.2.4. Graph All Callees ΓòÉΓòÉΓòÉ

The Graph All Callees menu item creates a graph of all the functions that the
currently selected function calls. These include the functions that the
selected function calls directly or indirectly.

This menu item will be disabled if the selected function calls no other
functions, has been declared but not defined, or if the source files containing
the function definitions has been handled by the QuickBrowse feature of the
Browser.


ΓòÉΓòÉΓòÉ 6.2.5. Graph All Callers and Callees ΓòÉΓòÉΓòÉ

The Graph All Callers & Callees menu item creates a graph of all the functions
that call the currently selected function and the functions that are called by
the currently selected function. These include the functions that the selected
function calls and are called by both directly or indirectly.

This menu item will be disabled if the selected function neither calls nor is
called by any other function, has been declared but not defined, or if the
source files containing the function definitions has been handled by the
QuickBrowse feature of the Browser.


ΓòÉΓòÉΓòÉ 6.2.6. Graph Immediate Callers and Callees ΓòÉΓòÉΓòÉ

The Graph Immediate Callers & Callees menu item creates a graph of all the
functions that call the selected function directly and are called by the
selected function directly.

This menu item will be disabled if the selected function neither calls nor is
called by any other function, has been declared but not defined, or if the
source files containing the function definitions has been handled by the
QuickBrowse feature of the Browser.


ΓòÉΓòÉΓòÉ 6.2.7. List Immediate Callers and Callees ΓòÉΓòÉΓòÉ

The List Immediate Callers & Callees menu item creates a list of all the
functions that call the selected function directly and are called by the
selected function directly. The resultant list is not sorted alphabetically as
items in a List window generally are. The classes are arranged in a depth first
tree traversal of the classes inheritance hierarchy.

This menu item will be disabled if the selected function neither calls nor is
called by any other function, has been declared but not defined, or if the
source files containing the function definitions has been handled by the
QuickBrowse feature of the Browser.


ΓòÉΓòÉΓòÉ 6.2.8. List Instantiations ΓòÉΓòÉΓòÉ

The List Instantiations menu item creates a list of the function template
instantiations of the selected function template.

Note that this menu item will be disabled if the selected function is not a
function template, has been declared but not defined, or if the source files
containing the instantiations have been handled by the QuickBrowse feature of
the Browser.


ΓòÉΓòÉΓòÉ 6.2.9. List Possible Exceptions Thrown ΓòÉΓòÉΓòÉ

The List Possible Exceptions Thrown menu item creates a list of all the
possible types of exceptions that could be thrown by the selected function, or
by any function that this function calls.

Note that this menu item will be disabled if the selected function calls no
other functions and it does not throw any exceptions itself, or if the source
files containing the function definitions has been handled by the QuickBrowse
feature of the Browser.

Note:   If the selected function calls another function, the menu item will be
        enabled, even though the function may not throw any exceptions. You
        will get a No Results Found message.


ΓòÉΓòÉΓòÉ 6.2.10. List Friendships ΓòÉΓòÉΓòÉ

The List Friendships menu item lists all the friendships that are defined for
the currently selected function. You can grant friendships to either a single
function or member function at a time, or to all the member functions of a
class at once. This action results in a list of all those classes that have
granted the selected class friendship.

Note that this menu item will be disabled if no classes have granted the
selected function friendship.


ΓòÉΓòÉΓòÉ 6.2.11. List Overriding Derived Classes ΓòÉΓòÉΓòÉ

The List Overriding Derived Classes menu item creates a list of all the derived
classes of the class that this function is a member of.

Note that this menu item is disabled if the selected function is not a member
function of a class, or when no derived classes of the selected function's
class contain functions which override the selected function.


ΓòÉΓòÉΓòÉ 6.2.12. List Class Members With Inheritance ΓòÉΓòÉΓòÉ

The List Class Members with Inheritance menu item creates a List container view
of all the members of the class the selected function is a member of. The
resultant list is not sorted alphabetically as items in a List window generally
are. The classes are arranged in a depth first tree traversal of the classes
inheritance hierarchy.

Note that this menu item will be disabled if the selected function is not a
class member function.


ΓòÉΓòÉΓòÉ 6.3. Variable PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on a variable object:

    Edit Definition


ΓòÉΓòÉΓòÉ 6.3.1. Edit Definition ΓòÉΓòÉΓòÉ

The Edit Definition menu item launches the VisualAge for C++ Editor and loads
the file containing the definition of the currently selected variable. By
default, the editor is positioned to the first line of the definition of this
variable.


ΓòÉΓòÉΓòÉ 6.4. Type PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on a type object:

    Edit Definition
    Expand Typedef


ΓòÉΓòÉΓòÉ 6.4.1. Edit Definition ΓòÉΓòÉΓòÉ

The Edit Definition menu item launches the VisualAge for C++ Editor and loads
the file containing the definition of the currently selected typedef. By
default, the editor is positioned to the first line of the definition of this
typedef.


ΓòÉΓòÉΓòÉ 6.4.2. Expand Typedef ΓòÉΓòÉΓòÉ

The Expand Typedef menu item creates a list which contains successive
expansions of a typedef, until it contains only fundamental types.

Note that this menu item is disabled if the selected type is an enum.


ΓòÉΓòÉΓòÉ 6.5. File PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on a file object:

    Edit File
    Graph All Includers
    Graph All Includees
    Graph All Includers & Includees
    List Defined Objects

 The following menu item appears on the menu if you are in a Graph window:

    Center


ΓòÉΓòÉΓòÉ 6.5.1. Edit File ΓòÉΓòÉΓòÉ

The Edit File menu item launches the VisualAge for C++ Editor and loads the
selected file.


ΓòÉΓòÉΓòÉ 6.5.2. Graph All Includers ΓòÉΓòÉΓòÉ

The Graph All Includers menu item creates a graph of all the files that include
the currently selected file. These include both direct and indirect inclusion.

Note that this menu item is disabled if the selected file is not included by
any other file.


ΓòÉΓòÉΓòÉ 6.5.3. Graph All Includees ΓòÉΓòÉΓòÉ

The Graph All Includees menu item creates a graph of all the files that are
included by the currently selected file. These include both direct and indirect
inclusion.

Note that this menu item is disabled if the selected file does not include any
other file.


ΓòÉΓòÉΓòÉ 6.5.4. Graph All Includers and Includees ΓòÉΓòÉΓòÉ

The Graph All Includers & Includees menu item creates a graph of all the files
included by the currently selected file and all the files that include the
currently selected file. This includes both direct and indirect inclusion.

Note that this menu item is disabled if the selected file does not include any
other file, or if the selected file is not included by any other file.


ΓòÉΓòÉΓòÉ 6.5.5. List Defined Objects ΓòÉΓòÉΓòÉ

The List Defined Objects menu item creates a list of all the Browser objects
which are defined in the selected file.

Note that this menu item is never disabled, since this is an expensive action
to perform because Browser objects must be analyzed to get the lists of items
which are defined in the selected file. Because of this, you may see the No
Results Found message if the file contains no Browser object definitions.


ΓòÉΓòÉΓòÉ 6.6. Label PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on label objects:

    Expand
    Collapse


ΓòÉΓòÉΓòÉ 6.6.1. Expand ΓòÉΓòÉΓòÉ

The Expand menu item will expand the currently selected object entirely. You
will only see this menu item when you have a List window that is a container
view.


ΓòÉΓòÉΓòÉ 6.6.2. Collapse ΓòÉΓòÉΓòÉ

The Collapse menu item will collapse the currently selected object entirely.
You will only see this menu item when you have a List window that is a
container view.


ΓòÉΓòÉΓòÉ 6.7. List Window PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on the List window:

    Show Inheritance Graph
    Show Include File Graph
    List All Classes
    List All Files
    Expand All
    Collapse All


ΓòÉΓòÉΓòÉ 6.7.1. Show Inheritance Graph ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.7.2. Show Include File Graph ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.7.3. List All Classes ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.7.4. List All Files ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.7.5. Expand All ΓòÉΓòÉΓòÉ

The Expand All menu item expands all the objects in the current list. You will
only see Label objects and the Expand All menu item when you have a List window
that is a container view.


ΓòÉΓòÉΓòÉ 6.7.6. Collapse All ΓòÉΓòÉΓòÉ

The Collapse All menu item collapses all the objects in the current list. You
will only see Label objects and the Collapse All menu item when you have a List
window that is a container view.


ΓòÉΓòÉΓòÉ 6.8. Graph Window PopUp Menu ΓòÉΓòÉΓòÉ

You can perform the following actions on the Graph window:

    Show Inheritance Graph
    Show Include File Graph
    List All Classes
    List All Files
    Overview...
    Zoom in
    Zoom out
    Max Zoom in
    Max Zoom out
    Center
    Vertical
    Horizontal
    Weighting >


ΓòÉΓòÉΓòÉ 6.8.1. Show Inheritance Graph ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.2. Show Include File Graph ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.3. Overview... ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.4. Zoom in ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.5. Zoom out ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.6. Max Zoom in ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.7. Max Zoom out ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.8. Center ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.9. Vertical ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.10. Horizontal ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.11. Weighting > ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.11.1. Top ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.11.2. Center ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.8.11.3. Bottom ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.9. Graph Zone PopUp Menu ΓòÉΓòÉΓòÉ

You can select a particular region of the graph by clicking Mouse Button 1 and
dragging it across the graph. This creates a rectangular dotted box around the
selected region. You can get a Graph Zone PopUp menu using Mouse Button 2 on
this region. This PopUp has the following actions:

 Zoom in   Zooms in on the selected region.
 Save Graph As... Saves the selected region to a bitmap file.
 Print...  Prints the currently selected region.
 Copy      Copies the selected region to the clipboard.


ΓòÉΓòÉΓòÉ 6.9.1. Zoom in ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.9.2. Save Graph as... ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.9.3. Print... ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 6.9.4. Copy ΓòÉΓòÉΓòÉ

Copies the selected region of the graph to the clipboard. The copied image is
sized according to the bitmap settings specified in the Browser Settings
NoteBook Bitmap page.


ΓòÉΓòÉΓòÉ <hidden> Object-Action Pair ΓòÉΓòÉΓòÉ

You can perform actions on any Browser object from the object's PopUp menu. Use
Mouse Button 2 over the object to invoke the PopUp menus. The Browser remembers
the last 40 unique object-action pairs and lists them in the History dialog for
quick access.

The List and Graph window each have an Action Status Bar which is located
directly below the menubar. It indicates what object and action were used to
create the current contents of the window.


ΓòÉΓòÉΓòÉ <hidden> Browser Database ΓòÉΓòÉΓòÉ

A Browser database is the in-memory representation of all the facts about the
.EXE, .DLL, or .LIB, or collection of .PDBs, or the results of a merge
operation. When you perform a new load, or when you exit the Browser, the
contents of this representation are stored into a Browser database file. The
next time you browse this program, the saved Browser database file is quickly
loaded into memory. For example, if you loaded a program called PROG.EXE into
the Browser, the saved Browser database file would be PROG.PDE. If you loaded a
DLL called PROG.DLL into the Browser, the saved Browser database file would be
PROG.PDD. If you loaded a library file called PROG.LIB into the Browser, the
saved Browser database file would be PROG.PDL.

If you did a merge, or loaded individual .PDB files, then the Browser would not
know what to call the file that is to be saved. In this case, the program that
is being browsed is conceptually a psuedo-library, so it will save the memory
representation of this pseudo-LIB as a .PDL. You will be prompted as to whether
to save this Browser database. If you choose Yes, then the Save Database As...
dialog appears.


ΓòÉΓòÉΓòÉ <hidden> Graph Selection Area ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ <hidden> Container View ΓòÉΓòÉΓòÉ

A container view is a list which can be used to show or hide selected
information. Use the  and  icons to expand and collapse the components of the
list. You can get this type of view by performing the following actions:

 o List Members with Inheritance (on a class)
 o List Friends (on a class)
 o List Class Members with Inheritance (on a function)
 o List Defined Objects (on a file)
 o List Immediate Callers & Callees (on a function)


ΓòÉΓòÉΓòÉ <hidden> QuickBrowse ΓòÉΓòÉΓòÉ

The QuickBrowse feature allows you to quickly obtain and browse type
information for code for which there is no compiler generated (/Fb) Browser
information. Use QuickBrowse for the following reasons:

 o It is faster than compiling the code
 o You may be able to browse files that do not compile

 Note:   The QuickBrowse feature is only available when the Browser is started
         from an IBM WorkFrame project.

 QuickBrowse parses the top level declarations which must be valid C++
 statements, and ignores the bodies of function definitions.

 You may want to use QuickBrowse if you are not interested about function call
 information.  Also, if you have code where the type information is well
 defined, but function bodies will not compile, you can browse the type
 information with QuickBrowse.

 If you are browsing in a project, and the Browser detects that some, or all,
 information is missing, a dialog will appear telling you that this information
 is missing, and will give you the option of QuickBrowsing the files for which
 data is missing.  Messages will appear in the Project's monitor, just as if
 you were doing a build.

 Note that the QuickBrowse feature is not a complete replacement to the
 Generate Browser information (/Fb) compiler option. The speed of QuickBrowse
 does come at a cost in the richness of information provided. Since the
 QuickBrowse feature does not look inside of function bodies, function call and
 exception information are not available. If you need to know this kind of
 information, then you will need to compile the file and use the Generate
 Browser information (/Fb) option.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

No results were found in the data for the requested action.  This may be caused
by one of the following common reasons:

 o If you are browsing a library for which you do not have the source, or are
   using such a library, then the call information will not be available.
   Actions such as List Immediate Callers & Callees or Graph All Callers &
   Callees could show no results. Also, without the call information, List
   Possible Exceptions Thrown would similarly result in no results.

 o Even with call information, unless a function throws an exception, or calls
   a function which does, the List Possible Exceptions Thrown action will
   return no results.

 o Class actions such as List Friends or List Friendships may result in no
   results being found because no such relationships exist.


ΓòÉΓòÉΓòÉ <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> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The file could not be found. You may need to change the search path specified
in the Browser Settings NoteBook Paths page.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The definition of the selected object is unknown.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The currently selected object could not be found in the VisualAge for C++
online doucmentation.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

iview.exe could not be found. Update your PATH environment variable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The Browser How Do I... information could not be found. The cause could be
either:

 o The HELP environment variable does not include the VisualAge for C++ help
   directory,
 o The DPATH environment variable does not include the directory where the
   cpphdi.opt file is located,
 o The PATH environment variable does not include the directory where the
   ipfcntrl.dll file is located, or
 o The VisualAge for C++ documentation was not installed.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The file could not be opened. Check to make sure the file you are trying to
load is a valid .DLL, .EXE, .LIB, .PDD, .PDE, .PDL, or .PDB file.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

 Either the path is invalid, the directory is read only, or the file is
damaged. The Browser profile (ibrs.ini) could not be loaded. Delete the
existing ibrs.ini file


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The Browser processes the makefile before the QuickBrowse starts. This is done
in order to capture the compiler options or any new files added (if necessary).
An error has occurred during the processing of the makefile. Either the
makefile or target is in error, or not all the sources are found.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

Launching of the IBM WorkFrame Monitor failed. The Monitor is started to
capture the output of the QuickBrowse. For some reason, Brsmon could not be
started properly. The action Brsmon is defined during installation. Please make
sure VisualAge for C++ is installed properly. If problem persists, contact your
IBM Service Representative.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

QuickBrowse could not be started properly. This may be a system resource
problem. Reduce your system activity, and try again.

If problem persists, contact your IBM Service Representative.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified Dynamic Link Library (.DLL) could not be loaded. Please make sure
the environment variable PATH includes the path where this .DLL is stored.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified file is critical to the Browser and could not be found. Please
make sure the file exists. Update the PATH environment variable to include this
file's directory.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified file could not be loaded due to an internal problem. Please
contact your IBM service representative.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The format of the file is unrecognized. The file may be:

 o An old format .LIB file. If .OBJs and .PDBs are available, you can rebuild
   the .LIB without the /NOBROWSE option. If they are not available, you should
   add this .LIB file to the Library Files list located on the Browser Settings
   NoteBook Paths page. Note that this file is not browsable. If the file is an
   import library, then it is also not browsable.

 o An old format .DLL/.EXE. If .OBJs and .PDBs are available, you can relink
   the file using the /BROWSE Linker option, or recompile with the /Fb option.
   If they are not available, then this file is not browsable.

 o An invalid file has been passed. Please verify that the file is either an
   executable (.EXE), library (.LIB), or dynamic link library (.DLL).

 Note:   You may also see this message when all of the following are true:

 o You are browsing a project, whose target is an .EXE.

 o The target of the project does not exist.

 o A file with the same file name as the target exists somewhere in your PATH.
   It is some other format of file that has been renamed as an .EXE.

 If this happens, you may ignore the message.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The file contains no browse information. If .OBJs and .PDBs are available, you
can rebuild the .DLL or .EXE using the /BROWSE Linker option or the .LIB
without the /NOBROWSE Library Manager option. If they are not available, you
should add the .LIB file to the Library Files list located on the Browser
Settings NoteBook Paths page. Note that this file is not browsable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified file could not be opened. Please verify you have the proper
access authority to the file.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified file could not be found. Please make sure the file is available.
That is, that the file exists and that it is located in a directory specified
in the PATH environment variable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The specified file name is unrecognized by the Browser. The file suffix must be
either .PDB, .PDL, .PDD, .PDE, .LIB, .DLL, or .EXE.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

Two different .PDB file names are from the same source. The second .PDB file
will be ignored. The Browser database has not been changed.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The data in the displayed .PDB file is out of date. Please rebuild the
specified target with the /Fb compiler option to make sure all the .PDB files
are up to date.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The version of the message file is not the version expected. This is most
likely a setup or configuration problem on your machine. The VisualAge for C++
Browser uses two message files, called CPPWBM35.DLL and CPPWMSG.DLL. A likely
cause of the problem is that you have either copied an older or newer version
of one of these files or the CPPWBT35.DLL file, or you have altered either your
PATH or HELP environment variables. Please reinstall VisualAge for C++ to
correct the problem if you have copied over any of these files. If you have
changed either the PATH or HELP environment variable, update it to include the
directory where these files reside.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The VisualAge for C++ Browser uses two message files, called CPPWBM35.DLL and
CPPWMSG.DLL. Either you have erased one or both of these files, or have
recently altered your environment variable. Please reinstall VisualAge for C++
to correct the problem if you have erased either of these files. If you have
changed the PATH environment variable, update it to include the directory where
these files reside.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The VisualAge for C++ Browser uses two message files, called CPPWBM35.DLL and
CPPWMSG.DLL. You have copied some other file over one of these files or have
recently altered your HELP environment variable. Please reinstall VisualAge for
C++ to correct the problem if you have copied over these files. If you have
changed the HELP environment variable, update it to include the directory where
these files reside.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

You must enter a positive integer for the number of copies and the horizontal
and vertical pages.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

No printer queue is installed on the system.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The margins specified in the Page Setup dialog are invalid. The print area
resulting from these margins is too small to accomodate the current graph or
list. Please change the margins to ensure the print area of the page is large
enough to print the graph or list.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The form name chosen in the Page Setup dialog is different than the one
specified in the Job Properties dialog for the currently selected printer.

If you want to change the form used:

  1. Select the form as the default in the Job Properties dialog.
  2. Select the matching form name in the Page Setup dialog.

 Note:   For the current print job, the form specified in the Job Properties
         will be used.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The form name chosen in the Page Setup dialog is not available for the
currently selected printer. To change the form name:

  1. Select a form as the default in the Job Properties dialog.
  2. Select the matching form name in the Page Setup dialog.

 Note:   For the current print job, the default form specified in the Job
         Properties dialog for the currently selected printer will be used.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The data in the displayed file is incompatible with the current Browser
database during the merge action. This might be caused by:

 o Two files containing the same class name, but the classes are different.

 o An external variable has been defined in two different files.

 Since the Browser database was not saved before the merge action, the Browser
 database cannot be restored to its previous content. No application will be
 loaded.

 Please make sure all global class names are unique, and there is only one
 definition for an external variable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The data in the displayed file is incompatible with the current Browser
database during the merge action. This might be caused by:

 o Two files containing the same class name, but the classes are different.

 o An external variable has been defined in two different files.

 The Browser database will be restored by using the saved Browser database
 file.

 Please make sure all global class names are unique, and there is only one
 definition for an external variable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The definition of the displayed class symbol in the current database is
different with that in the file being loaded. This might be caused by two files
containing the same class name, but the classes are different. Please make sure
all the global class names are unique.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The displayed external variable symbol has been defined twice. Please make sure
there is only one definition for the displayed external variable.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

After changing the graph node font, the node may not be resized properly. The
font may appear to be too small or too big in a node. To correct the problem,
open the History window and select the object-action pair for the current
graph. All the nodes are redrawn properly.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The displayed function symbol has been defined twice. Please make sure there is
only one definition for the displayed external function.


ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ

Explanation:

The requested graph is too complex for the operating system to compute.
Internal calculations to determine the graphical representation have exceeded
the limitation of the 16-bit GDI coordinate system used by Windows 95.

To work around the problem, try the following suggestions:

 o Change the orientation of the graph:

     1. Select the View PullDown menu.
     2. Change the orientation from Vertical to Horizontal, or vice versa.

 o Change the weight of the graph:

     1. Select the View PullDown menu.
     2. Select the Weighting > cascaded menu.
     3. Choose a different weight: Top, Center, or Bottom.

 o Choose a different graph to display:

     1. Select an item from the list area of the Graph window.
     2. Click mouse button 2 on the item to display the popup menu.
     3. Choose a graph action.

 o If you have Windows NT:

     1. Switch to Windows NT.
     2. Restart the Browser with the same data.
     3. Perform the same graph action, for the Windows NT uses a 32-bit GDI
        coordinate system.