Progress
Programming
Handbook
R-code Execution Environment Statistics
You can monitor execution environment activity using the Statistics (–y) and Segment Statistics (–yd) startup parameters. These parameters cause Progress to write memory statistics to the
client.mon
file. The –yd parameter provides all of the information about memory usage available with –y plus additional information about r-code segments loaded during a client session. For more information about the –yd and –y startup parameters, see the Progress Startup Command and Parameter Reference.For information about monitoring and optimizing r-code performance, see the Progress Client Deployment Guide.
Figure A–4 through Figure A–8 show sections of
client.mon
output generated with the –yd startup parameter.In Figure A–4, the “Progress client startup options” section shows the r-code directory size (–D), in this case, set to the default of 100 entries. The –y startup parameter also generates this information.
Figure A–4: Progress Client Startup Options for –yd
![]()
In Figure A–5, the “Execution buffer map” section shows the order and size of procedures loaded into the execution buffer.
Figure A–5: Execution Buffer Map for –yd
![]()
In Figure A–6, the “Per procedure temp file access statistics” section lists each r-code segment that has been read or written to the session sort file (.srt). Each segment is listed under its r-code file by segment type (“Int–Proc Action”), number (5), and size (1364 bytes).
Figure A–6: Accessing the Session Sort File for –yd
![]()
In this example, all segments shown have been read and written once. A large number of segments read or written a large number of times indicates a likely need for more memory.
In Figure A–7, the “Per procedure segment information” section lists all the r-code segments loaded during the session. Each segment is listed under its r-code file by segment type (“Int–Proc”), number (2), and size (816 bytes).
Figure A–7: Procedure Segment Information for –yd (Part 1)
![]()
Thus, if there are five internal procedure action segments in
adeedit/_prodedit.r
, they are listed in order (1 through 5). The number of segments for each entry is always 1. Note that the “Initial” and main “Action” segments have no segment number, because there is never more than one of these segment types per r-code file.In Figure A–8, the listed sections provide memory and segment usage summaries. The –y startup parameter also generates this information.
Figure A–8: Procedure Segment Information for –yd (Part 2)
The “R-code Execution Buffer” statistics show how far your application pushes the execution buffer ceiling. The “Segment Descriptors Usage” statistics shows how close your application is to running out of segment descriptors, and thus, whether you need to optimize the number of r-code segments in your application.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |