Progress
Startup Command and Parameter
Reference


Statistics (-y)

Operating 
System
and
Syntax 
UNIX
Windows 
-y 
Use
With 
Maximum
Value 
Minimum
Value 
Single-user
Default 
Multi-user
Default 
CS
 
 
 
 

Use Statistics (-y) to collect procedure access and usage statistics throughout the Progress session. At session end, Progress writes these statistics to the default output file client.mon. For detailed information on the output written to the client.mon file, see the Progress Database Administration Guide and Reference.

At startup, the -y parameter sends a report of all the startup parameters to the output file. This report includes all default values, overridden values, and values you set at startup. Unlike the other statistics that the -y parameter collects, this report is not written at session end and is not affected by the SHOW-STATS statement.

Note that the specific statistics displayed might change periodically as new Progress features are implemented.

The edit buffer map statistics are written each time a user exits from Progress or uses the SHOW-STATS statement. These lines list the procedures currently in the edit (or execution) buffer and their r-code sizes.

NOTE: If you cannot execute SHOW-STATS from the Procedure Editor or cannot add the statement to your Progress code (for example, if while using Run-time Progress), you can specify Statistics with CTRL-C (-yc) instead of the -y parameter. Both parameters behave the same way, except that -yc lets you use CTRL-C as a substitute for the SHOW-STATS statement.

The program-access statistics are written to the output file when the session ends or when you use the SHOW-STATS statement. In the output, temp file reads and writes are reads and writes to the SRT file, which stores each user’s session compiles and active r-code files. The Bytes column is a cumulative total. The Stat file checks are recorded because they represent a relatively time-consuming system call. Unless you invoke Quick Request (-q), Progress makes a stat call each time a precompiled subprocedure is called with the RUN statement.

Progress places the default output file (client.mon) in the current working directory. However, you can specify a different output file by using the CLIENTMON environment variable. Simply set CLIENTMON to point to the file you want to use.

For example, in a UNIX environment, if you wanted to use a file named stats in the /usr/tmp directory, enter the following command at the system prompt:

CLIENTMON=/usr/tmp/stats; export CLIENTMON 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095