DECUS Heritage

Version: 1.0, July 1989
Submitted By: Digital Equipment Corporation
Operating System: VAX/VMS V4.6,V5.0 through V5.2
Source Language: VAX FORTRAN, DCL, MACRO-32
Keywords: Tools - Applications Development, Utilities - VMS
Restrictions: Cannot do "BY LINE" analysis for VAX C, VAX Ada. Operating system VAX/VMS V4.6 through V5.2 is required.

---

Abstract: The Image PC Analysis tools measure where a user's program is spending its time. To do so, the tools periodically sample the program counter of the running program, determine in which portion of the program each such sample falls, and display the resulting information in histogram form.

The following is a brief summary of highlights:

• IMGSAMPLE - Consists of subroutines which collect PC samples by trapping a clock interrupt every ten minutes.
• IMGTRACE - Consists of subroutines which collect PC samples by tracing the user program; it thus retrieves every single instruction's PC value, but it also takes much more time than sampling on clock interrupts.
• IMGSHELL - Used to start and stop either IMGSAMPLE or IMGTRACE without modifications to the source of the program to be measured.
• DEFINE=IMAGE - Program through which the user specifies how his program is to be divided into sections called buckets. Each bucket is defined by an address range, and contains a counter which accumulates the number of PC samples in that address range.
• REPORT=IMAGE - Program which prints the accumulated data in histogram form with one histogram bar per bucket.

A program (CONVERT=SYSTEM_PC) to convert System PC files (collected with VAXSPM) is also provided. This tool enables the Image Analysis reporter to read the converted System PC file and report on that data file.

Click on FTP to download from the FTP Achives.

---

Last Update: Thu Jan 11 18:39:20 1996