This section provides information that you need before starting GPA for the first time.
GPA Version 3.0 runs on Compaq Tru64 UNIX Version 4.0D and higher.
GPA operations are generally most reliable when windows are
displayed through a Motif-based window manager such as
mwm
or
dtwm
-- the CDE window manager.
When using the
mwm
window manager, OSF/Motif
Version 1.2 is required for running GPA Version 3.0.
See the OSF/Motif
documentation set for information about installing and using OSF/Motif.
GPA may experience color mapping problems when run along with one or more applications that use many colors and that run on an eight-plane graphics system, for example, Netscape. This is particularly noticeable if you start GPA when an application such as Netscape is already running. Symptoms include partial loss of colors in GPA tool displays.
The simplest solution to GPA color loss is to stop the additional
application.
In the case of Netscape, you can also invoke it with
the
-install
option, which allows Netscape to
make more efficient use of colors.
The
DXmPrint
widget widget uses the file
/etc/printcap
to populate its list of printers.
If this file does not exist or is incorrect and you try to print,
GPA issues either of two possible warning message on the command
line:
Printer name too long.
Cannot access printer
description file
If you see this message, you need to set up your
/etc/printcap
file.
When the system running GPA is heavily loaded, some X Toolkit resource requests might be inadvertently ignored. The height settings of some dialog boxes might be incorrect as a result. If the dialog box has a scroll bar, the following messages may be displayed in the terminal emulator window from which you started GPA:
GPA: `gpa-tool-name': warning/error :
Name: hbar
Class: XmScrollBar
The specified slider size is less than 1
To correct this problem, manually resize the dialog box.
Your application will not work correctly if it does I/O to
/dev/tty
.
Use of Ctrl/C, Ctrl/Z and similar
job control characters in the I/O window do not work.
Try running
your application outside the Heap Analyzer.
To run your application outside the Heap Analyzer:
Set your LD_LIBRARY_PATH to start with your data directory (which is your working directory if you haven't explicitly set the data directory).
Run this file with any command-line options your
application needs:
data-directory-name/executable-name.third
See the man page third(5) for information about setting Third Degree options.
There are occasional problems when switching to Generate mode
for the first time.
It can cause a message
Out of ptys
to be displayed.
If this happens, exit the tool and restart.
Usually
that is enough, although sometimes you need to do this several times.
Your application will not work correctly if it does I/O to
/dev/tty
.
Use of Ctrl/C, Ctrl/Z and similar
job control characters in the I/O window do not work.
Try running
your application outside the Performance Profiler.
To do this for the
hiprof
tool, run this
file with any command-line options your application needs:
data-directory-name/executable-name.hiprof
To do this for
pixie
, run this file with
any command-line options your application needs:
data-directory-name/executable-name.pixie
To do this for
prof
or
gprof
,
run this file with any command-line options your application needs:
data-directory-name/executable-name
See the relevant man pages for information about the options.
There are occasional problems when switching to Generate mode
for the first time.
It can cause a message
Out of ptys
to be displayed.
If this happens, exit the tool and restart.
Usually
that is enough, although sometimes you need to do this several times.
Do not stop
pinfo
using
kill -9
because this can cause processes to hang (and there is no way to
keep this from happening).
A simple
kill
should
be sufficient, because
pinfo
catches
SIGINT
and
SIGTERM
and uses them to force a clean exit.
You cannot use an IP address to specify a host when you connect to a host to run Process Viewer. Instead, you must use the host name.
The Man Page Browser searches using a regular expression. However, in the case of ^ (beginning of line) and $ (end of line), the Man Page Browser may make false positive hits. This should only happen around hotspots.
Hitting the Help button rapidly when there are no HyperHelp Viewers running may invoke multiple viewers. Only one responds to your tool's control.
When you request help on the Print dialog box (which appears when you choose File: Print) or the Color dialog box (which appears when you choose Options: Colors and click on an entry in the Options - Colors dialog box), the Tru64 UNIX Bookreader is invoked. The Bookreader may be unable to locate the file containing the requested help.
To set up a printer for use by the HyperHelp Viewer, choose Help: How to Use Help from the HyperHelp Viewer and follow the instructions on Installing a New Printer.
To run the Memory Profiler, Process Viewer, Performance Profiler,
or Heap Analyzer from the command line after installation, use the
following commands, respectively:
mview
,
pview
,
dxprof
, or
dxheap
.
To view
the man pages, use the following commands:
man mview
,
man pview
,
man dxprof
,
and
man dxheap
.
We appreciate your comments, suggestions, and general feedback on the GPA tools and documentation.
To reach us, send email to the following adress:
application-development@compaq.com
Optionally, include your name, email address, and telephone number.