1 02/21/85 link_meters
 2 
 3 Syntax as a command:  link_meters {-control_arg}
 4 
 5 
 6 Function:  prints out per-process information regarding use of the
 7 Multics linker.  The statistics are obtained from the Process
 8 Descriptor Segment (PDS) of the process.  System-wide linkage
 9 information can be obtained with the system_link_meters command.
10 
11 
12 Control arguments:
13 -report_reset, -rr
14    generates a full report and then performs the reset operation.
15 -reset, -rs
16    resets the metering interval for the invoking process so that the
17    interval begins at the last call with -reset specified.  If -reset
18    has never been given in a process, it is equivalent to having been
19    specified at process initialization time.
20 
21 
22 Access required:  This command requires access to phcs_ or
23 metering_gate_.
24 
25 
26 Notes:  If the link_meters command is given with no control argument,
27 it prints a full report.
28 
29 The following are brief descriptions of the variables printed by the
30 link_meters command.
31 slot
32    is a time slot into which the calls to the linker are broken down.
33    The four slots are for calls completed in less than 25 milliseconds,
34    calls completed in between 25 and 50 ms, calls completed in between
35    50 and 75 ms, and calls completed in more than 75 ms.
36 calls
37    is the number of calls to the linker that are completed in each time
38    slot and the total number of calls made to the linker by the
39    process.
40 
41 
42 avg time
43    is the average time (in milliseconds) to completion for a call in
44    each slot and the average time to completion for all calls to the
45    linker made by the process.
46 avg pf
47    is the average number of page faults for a call in each slot and the
48    average number of page faults for all calls made by the process.
49 tot time
50    is the total virtual time (in seconds) taken by calls in each slot
51    and the total virtual time spent in the linker by the process.  It
52    equals calls times average time.
53 % time
54    is the percentage of total linker time for the process that was
55    taken by calls in each slot and the percentage taken by all calls.