!PCHIST - PC Histogram Program
!
!ORIGIN:  DAVE ELDERKIN  DEC, ROGER LIPSETT  INTERMETRICS
!
!INSTALLATION:  FOR PCHIST
!		MAC SYM
!		MAC GETCMD
!		LINK PCHIST,SYM,GETCMD
!
Invokes the PCHIST program to produce PC histograms from raw data
written during a run of a program.
PCHIST requires the existence of a file named PC.DAT, which contains
the raw data.  This file is produced during the run of the program being
analyzed. (See TIME.HLP for more information).
Format
 $ PCHIST Image_name [/option]...]
	(where PCHIST is a symbol whose value is "DB1:[UTILITY]PCHIST".
	 The name of the symbol may, of course, be anything else you choose.)
*Parameter
Image_name
 Specifies the name of the image file from which the PC raw data was
 produced.  The image file must have been compiled and linked with /DEBUG
 in order to produce a symbol table.  FORTRAN routines may be compiled
 optimized, however.
 The default extension for the image name is .EXE.
*Options
/OUTPUT=file-spec
 Specifies the one and only output file.  If this option is not specified,
 SYS$OUTPUT is used.  The default extension, if none is given, is .HST.
/LONG (D)
/SHORT
 These options specify whether detailed per-routine PC data is to be
 written to the output file, or whether only a summary of the top CPU
 users is to be written.
/GRANULARITY=n (D=16)
 The granularity option allows the user to control the "resolution" of
 the resulting histogram.  A granularity of n means that a PC value, in
 the output, of X contains the hits for all PC's within n/2 of X.
 Note that the raw data in PC.DAT contains actual PC's, so that several
 runs at different granularities may be made without rerunning the program
 being analyzed.
*Examples
 $ PCHIST

  Prompts for all parameters

 $ PCHIST TEST/SHORT

  Input from TEST.EXE, summary only, output to SYS$OUTPUT, granularity 16.

 $ PCHIST FOO/GR=100/OUT=FOO

  Input from FOO.EXE, detailed listing, granularity 100, output to FOO.HST.
