ToString (UserStatistics function): Difference between revisions
m (1 revision) |
m (→Syntax terms) |
||
| Line 15: | Line 15: | ||
<tr><th><b>Zeros= </b><i>bool</i></th> | <tr><th><b>Zeros= </b><i>bool</i></th> | ||
<td>This name required argument (<tt>Zeros</tt>) is a boolean value that indicates whether statistics with a zero value should be included in the returned data. Zeros is an optional argument that defaults to <tt>False</tt>, which results in the inclusion of only statistics with non-zero values.</td></tr> | <td>This name required argument (<tt>Zeros</tt>) is a boolean value that indicates whether statistics with a zero value should be included in the returned data. Zeros is an optional argument that defaults to <tt>False</tt>, which results in the inclusion of only statistics with non-zero values.</td></tr> | ||
<tr><th>NamesToLower</th><td>This <var>[[Methods#Named parameters|Name-Required]]</var> argument is a <var>[[Boolean]]</var> value that indicates whether the returned <var class="product">Model 204</var> statistic names, which are normally all uppercase, should be returned as lowercase. This is an optional argument which defaults to <var>False</var>.</td></tr> | |||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
Revision as of 14:37, 30 March 2011
Print UserStatistics values (UserStatistics class)
This method prints the values of the statistics in the method UserStatistics
object.
It prints all statistics with non-zero values (by default), or it prints
all statistics (as an option).
Syntax
%string = userStatistics:ToString[( [Zeros= boolean], [NamesToLower= boolean])]
Syntax terms
| %ls | A longstring variable to contain the listing of the values of the statistics. |
|---|---|
| %ustat | A UserStatistics object variable. |
| Zeros= bool | This name required argument (Zeros) is a boolean value that indicates whether statistics with a zero value should be included in the returned data. Zeros is an optional argument that defaults to False, which results in the inclusion of only statistics with non-zero values. |
| NamesToLower | This Name-Required argument is a Boolean value that indicates whether the returned Model 204 statistic names, which are normally all uppercase, should be returned as lowercase. This is an optional argument which defaults to False. |
Usage notes
- The ToString method can be applied implicitly: simply Print (or Audit) an object variable, and the ToString method is automatically applied to the object. Print %statobject is equivalent to Print %statobject:ToString.
- The LoginToString function returns the values of the Login statistics in the UserStatistics object. The RequestToString function returns the values of the Request statistics in the object.
Examples
The following display of non-zero Login and Request statistics is produced by a
Print %ustat statement.
The output line wrapping is altered for display purposes.
time='20080730102646772' userNumber=6 loginTime='20080730- 102645880' login: cnct=1 sqrd=29 sqwr=4 sgmto=27 cpu=890 - req=1 move=97 slic=71 audit=32 dkar=253 dkpr=124751 pcpu=- 996 objswap=250247 request: ntbl=10 qtbl=29 stbl=524 vtbl- =51 pdl=508 cnct=1 cpu=887 out=1 slic=71 pcpu=996 rqtm=88- 9 dkpr=124750 objswap=250247
A Print %ustat:ToString(Zeros=true) statement would print all the statistics, including those with a 0 value.