UserStatistics class: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 14: | Line 14: | ||
<ul> | <ul> | ||
<li><div id="login"></div>Login statistics (also called “Final”) are those that keep data per user since the user's most recent login. The statistics available to the <var class="product">Model 204</var> <var>$Stat</var> function, as well as the OBJSWAP statistic for <var class="product">[[Janus SOAP]]</var> objects, are valid. | <li><div id="login"></div>Login statistics (also called “Final”) are those that keep data per user since the user's most recent login. The statistics available to the <var class="product">Model 204</var> <var>$Stat</var> function, as well as the OBJSWAP statistic for <var class="product">[[Janus SOAP]]</var> objects, are valid. | ||
<li><div id="request"></div>Request statistics are a combination of: | <li><div id="request"></div>Request statistics are a combination of: | ||
<ul> | <ul> | ||
| Line 19: | Line 20: | ||
current high-water marks for some work tables per user. | current high-water marks for some work tables per user. | ||
<var class="product">Model 204</var> documentation includes these with “since last” statistics. | <var class="product">Model 204</var> documentation includes these with “since last” statistics. | ||
<li>Since last statistics, which keep data per user comprising | <li>Since last statistics, which keep data per user comprising | ||
only the user's most recent work unit (like compilation or evaluation); | only the user's most recent work unit (like compilation or evaluation); | ||
| Line 30: | Line 32: | ||
that are restricted to one type or the other. | that are restricted to one type or the other. | ||
The [http://www. | The <i>[http://www.rocketsoftware.com/m204/products/index/documentation/v7r4/M204-System-Mgr/view Rocket Model 204 System Manager's Guide]</i> and the <var class="product">[[SirMon]]</var> documentation are good sources of information about the | ||
available statistics; note that not all <var class="product">SirMon</var> statistics | available statistics; note that not all <var class="product">SirMon</var> statistics | ||
are included in a <var>UserStatistics</var> object. | are included in a <var>UserStatistics</var> object. | ||
| Line 59: | Line 61: | ||
... processing | ... processing | ||
%statEnd = new | %statEnd = new | ||
printText CPU: {%statEnd:[[Difference(UserStatistics function)|difference]](%statStart, 'CPU')} | printText CPU: {%statEnd:[[Difference (UserStatistics function)|difference]](%statStart, 'CPU')} | ||
printText DKRDs: {%statEnd:difference(%statStart, 'DKRD')} | printText DKRDs: {%statEnd:difference(%statStart, 'DKRD')} | ||
end | end | ||
Revision as of 21:10, 20 November 2012
Intended for performance work, the UserStatistics class is designed to replace $STAT and similar tools that return the values for selected Model 204 User statistics.
The New constructor takes a snapshot of the user stat block at the time the constructor is invoked. You then use the UserStatistics methods to extract the statistical data from the instantiated object.
The UserStatistics class is new as of Sirius Mods version 7.3.
About the UserStatistics statistics
The object holds two types of user statistics: Login and Request.
- Login statistics (also called “Final”) are those that keep data per user since the user's most recent login. The statistics available to the Model 204 $Stat function, as well as the OBJSWAP statistic for Janus SOAP objects, are valid.
- Request statistics are a combination of:
- Statistics that keep the current high-water marks for some work tables per user. Model 204 documentation includes these with “since last” statistics.
- Since last statistics, which keep data per user comprising only the user's most recent work unit (like compilation or evaluation); they are not accumulated.
Login and Request statistics are not mutually exclusive. Both Login and Request data are kept for some activities, so many statistics appear in lists of both types and are valid in all methods that are restricted to one type or the other.
The Rocket Model 204 System Manager's Guide and the SirMon documentation are good sources of information about the available statistics; note that not all SirMon statistics are included in a UserStatistics object. Where they occasionally differ in spelling the name of a statistic, the Model 204 System Manager's Guide is more likely to have what the UserStatistics methods require.
You can also view all the individual statistics contained in a UserStatistics object by applying the ToString method to it, as follows:
Print %statObject:ToString(Zeros=true)
This displays all of
the Login statistics followed by all the Request statistics.
Note:
The ToString method shown above 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.
Example
The following is a simple example that shows how much CPU a request uses and how many DKRDs it did:
b %statStart is object userStatistics %statEnd is object userStatistics %statStart = new ... processing %statEnd = new printText CPU: {%statEnd:difference(%statStart, 'CPU')} printText DKRDs: {%statEnd:difference(%statStart, 'DKRD')} end
Specifying a statistic that is not a User statistic, or that is not the type of statistic (Login or Request) that a method calls for, triggers an UnknownStatistic exception.
List of UserStatistics methods
The "List of UserStatistics methods" shows all the class methods.