Help / Release / J 4.05 / Performance Monitor Utilities
>> << Pri JfC LJ Phr Dic Voc !: Rel NuVoc wd Help Release
Performance Monitor Utilities |
initial writing: 2000-07-17 |
PM is an extension to the facilities provided by the Performance Monitor
foreign conjunctions (6!:8 and 6!:13), which are described
in the J dictionary.
PM provides functions to turn the Performance Monitor on and
off, and analyze and display the results.
For the most part, you need only turn the Performance Monitor on, run
your application, then display the results.
To load, enter:
load 'jpm'
This populates the jpm locale. PM ignores any definitions in
this locale, so PM definitions should be run directly from this locale, rather
than from cover functions in the z or other locales.
The following are the main definitions:
start_jpm_ | set PM on | |
stop_jpm_ | set PM off | |
read_jpm_ | read PM data | |
showtotal_jpm_ | show totals | |
showdetail_jpm_ | show details | |
viewtotal_jpm_ | view totals | |
viewdetail_jpm_ | view details |
The definitions stop_jpm_ and read_jpm_ are usually not
required. If PM is on, any call to read_jpm_ will
call stop_jpm_ , while if the PM data has not
already been read, any call to the show or view verbs will
call read_jpm_ first.
Examples
First load jpm :
load 'jpm'
Example 1
start_jpm_ '' runapp '' showtotal_jpm_'' showdetail_jpm_ 'runapp' showdetail_jpm_ 'printapp'
Example 2
The following runs PM for app1 and app3, but not app2:
start_jpm_ '' app1 '' stop_jpm_ '' app2 '' start_jpm_ '' app3 '' showtotal_jpm_ ''
Example 3
start_jpm_ '' runapp '' viewtotal_jpm_ ''
This displays the PM results in a grid. Detail results for
any definition are shown by double-clicking the line in the grid.
Definitions
opt start_jpm_ size | opt = left argument to 6!:10 ,
(default 1=all lines, 0=wrap) | |
stop_jpm_ | Stops PM. If PM is already off, the call is ignored. | |
read_jpm_ | Read the PM data. If PM is on, stops PM. If PM data has
already been read, the call is ignored. | |
opt showtotal_jpm_ names | opt has 0 - 3 numbers: 0 - 0=time (default) 1=space | |
opt showdetail_jpm_ name | opt is 0=time (default) 1=space name is a single name, given as: name_locale_
or name;locale Show the PM detail data for the given name. If PM data has not yet been read, calls read_jpm_ first. | |
opt viewtotal_jpm_ names | View the PM total data in a grid. Arguments are the same as
for showtotal_jpm_ . | |
opt viewdetail_jpm_ name | View the PM total data in a grid. Arguments are the same as
for showdetail_jpm_ . |