ToString (UserStatistics function)

Print UserStatistics values (UserStatistics class)

ToString returns the values of the statistics in the method UserStatistics object. By default, it will only return statistics with non-zero values; but, optionally, may return all (including zero) statistics.

Syntax

%string = userStatistics:ToString[( [Zeros= boolean], [NamesToLower= boolean])]

Syntax terms

%string	A longstring variable to receive the listing of the values of the statistics.
userStatistics	A UserStatistics object variable.
Zeros	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

• ToString can be applied implicitly: simply Print (or Audit) an object variable, and the ToString method is automatically applied to the object. That is:

  print %statobject

  is equivalent to

  print %statobject:ToString

  .

Examples

1. 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

2. print %ustat:ToString(Zeros=true)

   statement would print all the statistics, including those with a 0 value.

See also

• LoginToString returns the values of the Login statistics in the UserStatistics object.
• RequestToString returns the values of the Request statistics in the object.

UserStatistics class	List of UserStatistics methods	UserStatistics methods syntax
Notation conventions for methods