envos SYSTATS 2 4 1 SYSTATS 1 4 By: Johannes A. G. M. Koomen (Koomen.wbst@Xerox or Koomen@CS.Rochester) This document last edited on: October 28, 1987 SUMMARY SYSTATS provides a functional interface to system statistics such as PageFaults, DiskIOTime, etc. Statistics are maintained in objects of type SYSTATS. Functions are provided to fetch values from these objects, and to update the objects to reflect the current system state or to compute differences. This facility provides a Lyric alternative to the (undocumented) MISCSTATS functions in Koto. DESCRIPTION SYSTATSPROPS [Variable] A list of statistics maintained by SYSTATS. Changing it does not alter SYSTATS behavior. (SYSTATSPROP prop fromstats) [Function] If fromstats is NIL, the internal SYSTATS object is updated and used. Retuns the value of the statistic named by prop, which must be a member of the variable SYSTATSPROPS. Caveat: The value returned is a FIXP which is an element of the fromstats object and which, for the sake of performance, is reused during a SYSTATSREAD on the fromstats object. Note that there is an implicit SYSTATSREAD on the internal SYSTATS object if fromstats is NIL. (SYSTATSREAD intostats fromstats) [Function] If intostats is NIL, it is set to a newly created SYSTATS object. If fromstats is NIL, the internal SYSTATS object is updated and used. Copies system statistics from fromstats into intostats. Retuns intostats. (SYSTATSDIFF oldstats newstats difstats) [Function] If oldstats is NIL, the internal SYSTATS object is updated and used in its place. If newstats is NIL, the internal SYSTATS object is updated and used in its place. If difstats is NIL, it is set to a newly created SYSTATS object. Computes the statistics differences between oldstats and newstats, and places the results in difstats. Retuns difstats. (CLOCKTICKS interval timerunits) [Function] Returns the (machine dependent!) number of internal clock ticks over the interval. For instance, on the D'Lion, (CLOCKTICKS 2.5 'MINUTES) = 5211900. (LIST ((PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC "" "") STARTINGPAGE# 258) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC "" "")) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL (PAPERSIZE NIL . LETTER) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO NIL) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL (PAPERSIZE NIL . LETTER) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO NIL) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL)))))3T2,8H ,,8,8H PAGEHEADING RUNNINGHEAD CLASSICCLASSICCLASSIC HELVETICA MODERN MODERN MODERN MODERNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN J/   >   g 7: V W    : Z      K K c       sz