Example of mmpmon rhist s request

This topic is an example of the rhist s request to display the request histogram facility statistics values and the output that displays.

Assume that commandFile contains this line:
rhist s
and this command is issued:
mmpmon -p -i commandFile
The output is similar to this:
_rhist_ _n_ 199.18.2.5 _nn_ node1 _req_ s _rc_ 0 _t_ 1066939007 _tu_ 386241 _k_ r
_R_      65536      131071 _NR_      32640
_L_        0.0         1.0 _NL_      25684
_L_        1.1        10.0 _NL_       4826
_L_       10.1        30.0 _NL_       1666
_L_       30.1       100.0 _NL_        464
_R_     262144      524287 _NR_       8160
_L_        0.0         1.0 _NL_       5218
_L_        1.1        10.0 _NL_        871
_L_       10.1        30.0 _NL_       1863
_L_       30.1       100.0 _NL_        208
_R_    1048576     2097151 _NR_       2040
_L_        1.1        10.0 _NL_        558
_L_       10.1        30.0 _NL_        809
_L_       30.1       100.0 _NL_        673
_rhist_ _n_ 199.18.2.5 _nn_ node1 _req_ s _rc_ 0 _t_ 1066939007 _tu_ 386241 _k_ w
_R_     131072      262143 _NR_      12240
_L_        0.0         1.0 _NL_      10022
_L_        1.1        10.0 _NL_       1227
_L_       10.1        30.0 _NL_        783
_L_       30.1       100.0 _NL_        208
_R_     262144      524287 _NR_       6120
_L_        0.0         1.0 _NL_       4419
_L_        1.1        10.0 _NL_        791
_L_       10.1        30.0 _NL_        733
_L_       30.1       100.0 _NL_        177
_R_     524288     1048575 _NR_       3060
_L_        0.0         1.0 _NL_       1589
_L_        1.1        10.0 _NL_        581
_L_       10.1        30.0 _NL_        664
_L_       30.1       100.0 _NL_        226
_R_    2097152     4194303 _NR_        762
_L_        1.1         2.0 _NL_        203
_L_       10.1        30.0 _NL_        393
_L_       30.1       100.0 _NL_        166
_end_

This small example shows that the reports for read and write may not present the same number of ranges or even the same ranges. Only those ranges with non-zero counters are represented in the response. This is true for both the request size ranges and the latency ranges within each request size range.

If the -p flag is not specified, then the output is similar to:
mmpmon node 199.18.2.5 name node1 rhist s OK timestamp 1066933849/93804 read
size range            65536 to    131071 count      32640
  latency range         0.0 to       1.0 count      25684
  latency range         1.1 to      10.0 count       4826
  latency range        10.1 to      30.0 count       1666
  latency range        30.1 to     100.0 count        464
size range           262144 to    524287 count       8160
  latency range         0.0 to       1.0 count       5218
  latency range         1.1 to      10.0 count        871
  latency range        10.1 to      30.0 count       1863
  latency range        30.1 to     100.0 count        208
size range          1048576 to    2097151 count      2040
  latency range         1.1 to       10.0 count       558
  latency range        10.1 to       30.0 count       809
  latency range        30.1 to      100.0 count       673
mmpmon node 199.18.2.5 name node1 rhist s OK timestamp 1066933849/93968 write
size range           131072 to     262143 count     12240
  latency range         0.0 to        1.0 count     10022
  latency range         1.1 to       10.0 count      1227
  latency range        10.1 to       30.0 count       783
  latency range        30.1 to      100.0 count       208
size range           262144 to     524287 count      6120
  latency range         0.0 to        1.0 count      4419
  latency range         1.1 to       10.0 count       791
  latency range        10.1 to       30.0 count       733
  latency range        30.1 to      100.0 count       177
size range           524288 to    1048575 count      3060
  latency range         0.0 to        1.0 count      1589
  latency range         1.1 to       10.0 count       581
  latency range        10.1 to       30.0 count       664
  latency range        30.1 to      100.0 count       226
size range          2097152 to     4194303 count      762
  latency range         1.1 to         2.0 count      203
  latency range        10.1 to        30.0 count      393
  latency range        30.1 to       100.0 count     166
If the facility has never been enabled, then the _rc_ value is non-zero:
_rhist_ _n_ 199.18.1.8 _nn_ node1 _req_ reset _rc_ 1 _t_ 1066939143 _tu_ 148443
If the -p flag is not specified, then the output is similar to:
mmpmon node 199.18.1.8 name node1 rhist reset status 1
not yet enabled

An _rc_ value of 16 indicates that the histogram operations lock is busy. Retry the request.

For information on interpreting the mmpmon command output results, see Other information about mmpmon output.