Progress
Startup Command and Parameter
Reference
Statistics With Cross-reference (-yx)
Use Statistics with Cross-reference (
-yx
) to collect procedure call statistics and write them to an output file. With this parameter, you can monitor information to answer the questions:Progress places the default output file for the
-yx
parameter,proc.mon
, in your current working directory. However, you can specify a different output file by using the PROCMON environment variable. Simply set PROCMON to point to the file you want to use.For example, in a UNIX environment, if you want to use a file named
stats
in the/usr/tmp
directory, enter the following command on the command line:
Use the SHOW-STATS statement to write the procedure call statistics to the output file. The CLEAR option sets all counters and timers (such as Calls and Time) to 0. When you exit Progress, the
-yx
parameter writes the procedure call statistics to the output file whether or not you use SHOW-STATS.Figure 4–1 shows sample procedure call statistics as they appear in the output file.
Figure 4–1: Sample Output From -yx Startup Parameter
The fields that appear in the output file
proc.mon
are as follows:Caller
The names of any calling procedures. The word <top> indicates that there was no calling procedure, and that you ran the called procedure directly from the Progress Procedure Editor.
Callee
The names of the called procedures.
Load Size
The size, in bytes, of each called procedure as Progress loads it into memory.
If you see a load size of 0, the called procedure is an uncompiled source procedure (
.p
file), or an r-code file (.r
file) that was previously loaded into memory.Calls
The number of times the Caller procedure calls the Callee procedure.
Rd Bytes
Generally, the called procedure’s load size. However, if the procedure is swapped out of memory and later restored, Rd bytes equals the procedure’s Load Size added to the number of bytes read from the SRT file. Rd Bytes grows larger each time the procedure is swapped out of memory and restored from the SRT file.
Reread
The number of bytes Progress reads from the SRT file to restore a Caller procedure that was overwritten. Progress restores only what is necessary to continue executing the Caller procedure. In some cases, this is less than the amount swapped to the SRT file.
Time
The total execution time of the called procedure, in milliseconds.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |