home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
VSCPPv4.zip
/
VACPP
/
IBMCPP
/
HELP
/
CPPBRS.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-05-17
|
159KB
|
3,221 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 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 C++. To get
general VisualAge C++ usage or programming techniques, use the VisualAge
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
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
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-+ Zoom in on a graph.
Ctrl-- 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.
Alt-F7 Move window.
Alt-F8 Size window.
Alt-F9 Minimize window.
Alt-F10 Maximize 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 any class which
derives from SOMObject, and a SOM metaclass is any class which is 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 at file scope, these class templates will appear as
global variables. When you List All Classes, these instantiations will
not be listed. You can find these template class instantiations by
performing a search for all non-member variables. This will list all
non-member variables defined in your program. Now perform a find for
the template class name. 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 at file scope, these class templates will appear as
global variables. When you List All Classes, these templates will not
be listed. You can find these template classes by performing a
Search... for non-member variables. In addition, 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:
List Members with Inheritance on a class
List Friends on a class
List Class Members with Inheritance on a function
List Defined Objects on a file
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
Browser Settings NoteBook
Pages: Paths and Help Level
List Window Settings NoteBook
Pages: Settings, Colors, and Styles
Graph Window Settings NoteBook
Pages: Settings, Colors, Styles, and Bitmap
Which Perform Actions
Load Database Dialog
Merge Database Dialog
Save As Dialogs
Browser Print Dialog
Setup: Print Setup and Page Setup
Find Dialog
Search Database Dialog
History Window
Font Dialogs
Browser Files Dialog
Profile Dialog
Choose Object Dialog
Which Are Informational
New User Help Dialog
Overview Window
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:
A main menu bar whose PullDown menu actions affect the current window.
An Action Status Bar which describes what object and action produced the
currently viewed list.
A count that indicates how many program elements are in the current list,
excluding label objects.
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.
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.
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 maximum number of items you can list in a List window is 65533.
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:
A main menu bar whose PullDown menu actions affect the current window.
An Action Status Bar which describes what object and action produced the
currently viewed graph,
A count that indicates how many program elements (nodes) are in the
current graph.
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.
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.
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
print, save to a file, or copy to the clipboard the contents of the List
Area.
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.
Scroll bars located on the right side and bottom of the Graph Area. Use
these to scroll the Graph Area horizontally and vertically.
A divider located between the Graph Area and List Area. Use it to change
the proportion of the screen allocated to each area.
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. Note that
anything approaching this limit would not be clearly understandable.
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:
Paths
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 (icsbrs.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 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 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 (icsbrs.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 (icsbrs.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 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:
Settings
Colors
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 (icsbrs.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 (icsbrs.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
Note: Because of the variety of colors being used in one window, the colors
dropped from the OS/2 color palette will not work correctly. Any
changes made this way will not be stored in the Browser profile
(icsbrs.ini).
ΓòÉΓòÉΓòÉ 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:
Settings
Colors
Styles
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 (icsbrs.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
(icsbrs.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
Note: Because of the variety of colors being used in one window, the colors
dropped from the OS/2 color palette will not work correctly. Any
changes made this way will not be stored in the Browser profile
(icsbrs.ini).
ΓòÉΓòÉΓòÉ 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 icsbrs.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 an OS/2 bitmap. 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 OS/2 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.
Note: The format of the new .PDB files are incompatible with the .BRS files
generated by the previous release of the Browser, and the AIX format of
the .PDB files. You can probably erase these old files, unless want to
use them with the old Browsers. The good news is that the new .PDB
files are between 60-95% smaller than the .BRS files for the same input
files. On a large application, you will save many Megabytes of hard
disk space by recompiling and generating the new .PDB files.
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 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 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 duplicates
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 an OS/2 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 copies 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 (icsbrs.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.
You can perform wildcard finds using:
- An asterisk (*) to match any number of characters, and
- A question mark (?) to match one character.
Use the Case Sensitive CheckBox to perform case dependent searches.
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 if you used the Apply
PushButton, you can use it to find the next instance.
ΓòÉΓòÉΓòÉ 4.11. Search Dialog Help ΓòÉΓòÉΓòÉ
The Search dialog is a simple string-matching facility to help you find objects
in your programs or libraries. It does not have a complex query structure. In
fact, this search facility is merely a Find dialog which searches the entire
loaded Browser database with the following specifications:
Object (classes, functions, variables, types, or files).
Member Access (public, protected, private, or non-members).
Class (all, SOM, or non-SOM).
Function (all, virtual, pure virtual, or static).
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.
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.
Use the Case Sensitive CheckBox to perform case dependent searches.
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:
Enter foobar and deselect the Exact Match CheckBox.
Results: foobar and realfoobar.
An example using exact match:
Enter foobar and select the Exact Match CheckBox.
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 (icsbrs.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:
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:
Select Node Fonts... from the Graph window Options PullDown menu.
To change the Graph window List Area text:
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 the files that could not be located
in the neither the path used to create the program, the current directory, the
path specified in the Browser Settings NoteBook Paths page, the path specified
in your INCLUDE environment variable, nor the path specified in your DPATH
environment variable, and therefore these files cannot be QuickBrowsed.
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 (icsbrs.ini). The
default location is the \OS2 directory on the boot drive. If you want to change
this, enter the new directory path name into the TextEntry field. Select OK to
continue starting the Browser.
If later 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
either the Browser PullDown menu in the VisualAge C++ Editor or 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 C++ Open Class Library classes:
Load...
User Interface Classes
Collection Classes
I/O Stream Classes
Complex Math Classes
Database Access Classes
Application Support 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 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 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
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 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 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 C++ Open Class Library .
ΓòÉΓòÉΓòÉ 5.1.1.8. 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 loosing 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
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 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 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 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 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 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 C++ Open Class Library into the current Browser database.
ΓòÉΓòÉΓòÉ 5.1.2.8. 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 file, 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 an OS/2
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 OS/2 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 OS/2 Clipboard.
For graphs:
The copied image is sized according to the bitmap settings specified in the
Browser Settings NoteBook Bitmap page.
Note: If you have selected a region of the graph, only the selected portion
will be copied.
ΓòÉΓòÉΓòÉ 5.3. View Pulldown Menu ΓòÉΓòÉΓòÉ
The View PullDown menu only pertains to the Graph window. It allows you to:
See an overview of the entire graph
Zoom in on the graph
Zoom out on the graph
Maximum zoom in
Maximum zoom out
Center the currently selected node in the Graph Area
Display relationships vertically
Display relationships horizontally
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%.
For a selected area, the selected portion will be zoomed to the maximum
magnification so that it will appear its largest in the window.
ΓòÉΓòÉΓòÉ 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:
Top
Center
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 C++ libraries when
you installed VisualAge 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
VisualAge C++ Editor.
For more information on IBM WorkFrame, see the IBM WorkFrame section in the
User's Guide. For more information on VisualAge C++ Editor, see the VisualAge
C++ Editor 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 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. Visual Age C++ Help Menu Items ΓòÉΓòÉΓòÉ
The central portion of the Help PullDown menu is dedicated to all the online
documentation that is shipped with Visual Age C++. Making a selection from any
of these Cascade menus launches the Visual Age C++ documentation associated
with the menu item. You can find the same documentation in the Information
folder found in the Visual Age C++ Desktop folder.
The Cascade menus are organized as follows:
At A Glance
Provides general information on using Visual Age C++, such as what
is new in this release, the overall tutorial, a description of all
the sample programs, and answers to frequently asked questions.
Using Visual Age 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
Visual Age C++. Use How Do I... information to find out how to
perform common tasks within Visual Age C++.
C/C++
Provides access to the information that is specific to programming
in C and C++.
Class Libraries
Provides access to the Visual Age C++ Open Class Library
documentation.
Visual Programming
Provides access to the information that is specific to creating your
programs visually.
OS/2, PM, and Graphics
Provides access to the documentation for the key aspects of OS/2,
Presentation Manager, and graphics programming.
IPF, REXX, and Editing
Provides access to the IPF, REXX and Editor references.
SOM and WorkPlace Shell
Provides access to the information specific to SOM and the WorkPlace
Shell.
Multimedia
Provides access to the information that is specific to creating
multimedia applications.
ΓòÉΓòÉΓòÉ 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 either the editor as defined for your
project, if you have started the Browser from a IBM WorkFrame project, or the
Visual Age C++ Editor. The file containing the definition of the currently
selected class is loaded in to the editor. By default, the Visual Age C++
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 Visual Age
C++ Open Class Library documentation for the currently selected class.
Note that this function will only work with the Visual Age 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 global variables
that instantiate a class template, these class templates will only
appear in the Browser as variables. You will not be able to list the
instantiations of the original class template. When this data is
obtained from the compiler, the List Instantiations action will work as
expected. The global variables will be listed from data obtained by
compiler generated data.
ΓòÉΓòÉΓòÉ 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 Visual Age C++ libraries when
you installed Visual Age 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.
Note that this menu item will be disabled if no classes 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 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.2.1. Edit Definition ΓòÉΓòÉΓòÉ
The Edit Definition menu item launches either the editor as defined for your
project, if you have started the Browser from a IBM WorkFrame project, or the
Visual Age C++ Editor. The file containing the definition of the currently
selected function is loaded in to the editor. By default, the Visual Age C++
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 Visual Age
C++ Open Class Library documentation for the currently selected function.
Note that this function will only work with the Visual Age 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 funtion 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 either call the selected function directly 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.7. List Immediate Callers and Callees ΓòÉΓòÉΓòÉ
The List Immediate Callers & Callees menu item creates a list of all the
functions that either call the selected function directly and are called by
both directly or indirectly. 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 class 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
Expand
Collapse
ΓòÉΓòÉΓòÉ 6.3.1. Edit Definition ΓòÉΓòÉΓòÉ
The Edit Definition menu item launches either the editor as defined for your
project, if you have started the Browser from a IBM WorkFrame project, or the
Visual Age C++ Editor. The file containing the definition of the currently
selected variable is loaded in to the editor. By default, the Visual Age C++
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
Expand
Collapse
ΓòÉΓòÉΓòÉ 6.4.1. Edit Definition ΓòÉΓòÉΓòÉ
The Edit Definition menu item launches either the editor as defined for your
project, if you have started the Browser from a IBM WorkFrame project, or the
Visual Age C++ Editor. The file containing the definition of the currently
selected typedef is loaded in to the editor. By default, the Visual Age C++
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 either the editor as defined for your project,
if you have started the Browser from a IBM WorkFrame project, or the Visual Age
C++ Editor. The file is loaded in to the editor.
ΓòÉΓòÉΓòÉ 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 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 an OS/2 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:
List Members with Inheritance (on a class)
List Friends (on a class)
List Class Members with Inheritance (on a function)
List Defined Objects (on a file)
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:
It is faster than compiling the code
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:
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.
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.
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:
The drive was not ready. Make sure there is a diskette in the drive you
want to save the file to.
The diskette or disk you wanted to write to may be full. Delete some
files or specify another disk to write to.
The diskette or disk may be write-protected. Remove the write protection
on the disk to save the file on it.
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.
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 Visual Age C++ online
doucmentation.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
view.exe and viewdoc.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:
The HELP environment variable does not include the Visual Age C++ help
directory,
The DPATH environment variable does not include the directory where the
cpphdi.opt file is located,
The LIBPATH environment variable does not include the directory where the
ipfcntrl.dll file is located, or
The Visual Age 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 (icsbrs.ini) could not be loaded. Delete the
existing icsbrs.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. The Browser sends a message to the IBM
WorkFrame Message Router to start the action Brsmon. For some reason, Brsmon
could not be started properly. The action Brsmon is defined during
installation. Please make sure Visual Age 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 LIBPATH 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 LIBPATH or 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:
An old format .LIB file. If .OBJs and .PDBs are available, you can
rebuild the .LIB using the /BROWSE Linker 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.
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.
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:
You are browsing a project, whose target is an .EXE.
The target of the project does not exist.
A file with the same file name as the target exists somewhere in your
PATH, and this file is either a DOS .EXE or a Windows .EXE, or perhaps 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 .LIB/.DLL/.EXE using the /BROWSE Linker 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 LIBPATH 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 Visual Age C++
Browser uses two message files, called DDE45.MSG and DDE4B.MSG. A likely cause
of the problem is that you have either copied an older or newer version of one
of these files or the DDE4QBTX.DLL file, or you have altered either your
LIBPATH or HELP environment variables. Please reinstall Visual Age C++ to
correct the problem if you have copied over any of these files. If you have
changed either the LIBPATH or HELP environment variable, update it to include
the directory where these files reside.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The Visual Age C++ Browser uses two message files, called DDE45.MSG and
DDE4B.MSG. Either you have erased one or both of these files, or have recently
altered your HELP environment variable. Please reinstall Visual Age C++ to
correct the problem if you have erased either of these files. If you have
changed the HELP environment variable, update it to include the directory where
these files reside.
ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
Explanation:
The Visual Age C++ Browser uses two message files, called DDE45.MSG and
DDE4B.MSG. You have copied some other file over one of these files or have
recently altered your HELP environment variable. Please reinstall Visual Age
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:
Two files containing the same class name, but the classes are different.
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:
Two files containing the same class name, but the classes are different.
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.