Domain/PAK Software Release Document
Software Release 2.1
Part No. 008896
Revision 02
This document describes the
Domain/PAK software (version 2.1),
which consists of the DPAT, HPC, and
DSPST tools.
APOLLO COMPUTER INC.
330 Billerica Road
Chelmsford, Massachusetts 01824
Copyright c 1986, 1987 Apollo Computer Inc.
All rights reserved. Printed in U.S.A.
First Printing: June, 1986
Latest Printing: May, 1987
This document was formatted using the FMT tool distributed with the Domain
computer system.
Apollo and Domain are registered trademarks of Apollo Computer Inc.
3DGR, Aegis, D3M, DGR, Domain/Access, Domain/Ada, Domain/Bridge, Domain/C,
Domain/ComController, Domain/CommonLISP, Domain/CORE, Domain/Debug,
Domain/DFL, Domain/Dialogue, Domain/DQC, Domain/IX, Domain/Laser-26,
Domain/LISP, Domain/PAK, Domain/PCC, Domain/PCI, Domain/SNA, Domain/X.25,
DPSS/Mail, DSEE, FPX, GMR, GPR, GSR, Network Computing Kernel, NCK, Network
Computing System, NCS, Open Network Toolkit, Open System Toolkit, OST,
Personal Workstation, and Series 3000 are trademarks of Apollo Computer Inc.
Apollo Computer Inc. reserves the right to make changes in specifications and
other information contained in this publication without prior notice, and the
reader should in all cases consult Apollo Computer Inc. to determine whether
any such changes have been made.
THE TERMS AND CONDITIONS GOVERNING THE SALE OF APOLLO COMPUTER INC. HARDWARE
PRODUCTS AND THE LICENSING OF APOLLO COMPUTER INC. SOFTWARE PROGRAMS CONSIST
SOLELY OF THOSE SET FORTH IN THE WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER
INC. AND ITS CUSTOMERS. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT
CONTAINED IN THIS PUBLICATION, INCLUDING BUT NOT LIMITED TO STATEMENTS
REGARDING CAPACITY, RESPONSE-TIME PERFORMANCE, SUITABILITY FOR USE OR
PERFORMANCE OF PRODUCTS DESCRIBED HEREIN SHALL BE DEEMED TO BE A WARRANTY BY
APOLLO COMPUTER INC. FOR ANY PURPOSE, OR GIVE RISE TO ANY LIABILITY BY APOLLO
COMPUTER INC. WHATSOEVER.
IN NO EVENT SHALL APOLLO COMPUTER INC. BE LIABLE FOR ANY INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT
LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATING TO THIS PUBLICATION OR
THE INFORMATION CONTAINED IN IT, EVEN IF APOLLO COMPUTER INC. HAS BEEN
ADVISED, KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES.
THE SOFTWARE PROGRAMS DESCRIBED IN THIS DOCUMENT ARE CONFIDENTIAL INFORMATION
AND PROPRIETARY PRODUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.
Reader_Notice
This document resides on line in the /doc directory. To print a copy of this
document, use the PRF command with the -npag and -pr options.
PRF <file_pathname> -PR <printer_name> -NPAG
iii
Contents
Section Page
CHAPTER 1 OVERVIEW OF Domain/PAK RELEASE 2.1 . . . . . . . . . . . . . 1-1
CHAPTER 2 SOFTWARE INSTALLATION PROCEDURES . . . . . . . . . . . . . . 2-1
CHAPTER 3 DOCUMENTATION. . . . . . .. . . . . . . . . . . . . . . . . . 3-1
CHAPTER 4 BUGS AND BUG FIXES. . . . . . . . . . . . . . . . . . . . . . 4-1
4.1 Known Bugs in Software Release 2.1 . . . . . . . . . . . 4-1
4.2 Bugs Fixed at 2.1. . . . . . . . . . . . . . . . . . . . 4-1
Contents iv
CHAPTER 1
OVERVIEW OF Domain/PAK SOFTWARE RELEASE 2.1
This chapter describes Version 2.1 of the Domain/PAK (Domain Performance
Analysis Kit) software. The only change to the Domain/PAK software with this
release lets you run Domain/PAK on a node or server processor (DSP) that is
running SR9.6 or a more recent version of the Aegis or Domain/IX operating
system. You can also run Version 2.1 of the Domain/PAK software on a node or
server processor that is running 9.5.
Domain/PAK, the Domain Performance Analysis Kit consists of three tools that
help you analyze the performance of your applications. Each of the tools
examines performance at a different degree of detail:
o DSPST (Display Process Status) looks at the relative use of CPU time
by several processes at the system level. DSPST also shows you
network and disk activity for the node.
o DPAT (Domain Performance Analysis Tool) is an interactive tool that
looks at the performance of programs, including I/O, paging, and
system calls at the procedure level.
o HPC (Histogram Program Counter) looks at the performance of
compute-bound procedures at the statement level.
Due to system changes between SR9.5 and SR9.6, DPAT requires a version of
/lib/tblib that's compatible with the version of the operating system running
on the node. The installation procedure for Version 2.1 of Domain/PAK
ensures that the proper version is installed on the node.
NOTE: If you want to creep onto a node (with the Aegis crp command) to
run Domain/PAK, Domain/PAK must be installed on that node. If you
creep onto a node where Domain/PAK is not installed, and run your
own copy of DPAT, DPAT will not run. Instead you will see this
error message:
?(sh) "dpat" - unable to install a library required by object
module (process manager/loader)
The "library required" that's mentioned in the error message is
Domain/PAK 1-1 Version 2.1
/lib/tblib. Install Domain/PAK on the other node to ensure that
the correct version of tblib is installed.
Version 2.1 1-2 Domain/PAK
CHAPTER 2
INSTALLATION INFORMATION
You can add Domain/PAK Version 2.1 to a user node (one equipped with monitor
and keyboard) or a Domain server processor (DSP) that is running SR9.5 or a
more recent version of the Aegis or Domain/IX operating system. If the user
node or DSP is not running SR9.5 or a more recent version, follow the
appropriate software update procedures as described in Installing__Domain
Software (Order No. 008860) or in the appropriate release notes.
For directions about how to install this product, see the manual Installing
Domain_Software, (Order No. 008860).
NOTE: The user node or DSP must have a minimum of 450 blocks of available
disk space for a successful installation of this software.
Domain/PAK 2-1 Version 2.1
CHAPTER 3
DOCUMENTATION
Analyzing___Program___Performance__with__DPAK (Order Number 008906) fully
describes Domain/PAK, except where noted.
The minimum sample interval has been changed from 10 milliseconds to 1
millisecond to enable more frequent program samples. Thus, the following
paragraph replaces the current second paragraph on page 4-7 in the section
"Sample Interval:"
"You can change this interval by selecting sample interval in milliseconds,
and specifying a number (in milliseconds) to indicate how often DPAT should
sample the process. The minimum interval is 1 millisecond."
Domain/PAK 3-1 Version 2.1
CHAPTER 4
BUGS AND BUG FIXES
This chapter describes the known limitations, known bugs, and the bugs fixed
by Release 2.1.
4.1 Known Limitations in Software Release 2.1.
In some cases DPAT will report time spent in the `node_data/read_only file.
If you see this, it is probably because the program you are monitoring calls
library routines that do not follow standard stack conventions. The floating
point library (FPP), for example, does not follow standard stack
conventions. Therefore, if you are monitoring a program that uses the
floating point library, DPAT may report time spent in the
`node_data/read_only file.
4.2 Known Bugs in Software Release 2.1.
There are no known bugs at Release 2.1.
4.3 Bugs Fixed at 2.1
These bugs were fixed at this release:
o Previously, when you produced a hierarchical report in ANALYSIS
mode, you sometimes got erroneous reports about recursive calls that
did not occur. This problem has been fixed.
o When you run DPAT or DSPST on a color display in monochrome mode,
the text in the windows is now readable.
Domain/PAK 4-1 Version 2.1
Version 2.1 4-2 Domain/PAK