VMS Help RTL Routines, LIB$, LIB$STAT_TIMER  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Statistics, Return Accumulated Times and Counts routine
    returns to its caller one of five available statistics
    accumulated since the last call to LIB$INIT_TIMER. Unlike
    LIB$SHOW_TIMER, which formats the values for output, LIB$STAT_
    TIMER returns the value as an unsigned longword or quadword.

    Format

      LIB$STAT_TIMER  code ,value-argument [,handle-address]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 code

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    The address of a signed longword integer that contains a code to
    specify the statistic to be returned. The code specification must
    be an integer from 1 to 5.

    The following values are allowed for code:

    Value Statistic Returned

    1     Elapsed real time (quadword, in system time format)
    2     Elapsed CPU time (longword, in 10 millisecond increments)
    3     Count of buffered I/O operations (longword)
    4     Count of direct I/O operations (longword)
    5     Count of page faults (longword)

 value-argument

    OpenVMS usage:user_arg
    type:         unspecified
    access:       write only
    mechanism:    by reference

    The statistic returned by LIB$STAT_TIMER. The value-argument
    argument contains the address of a longword or quadword that
    is this statistic. All statistics are longword integers except
    elapsed real time, which is a quadword.

    See the OpenVMS System Services Reference Manual for more details
    on the system time format.

 handle-address

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    Pointer to a block of storage. The optional handle-address
    argument contains the address of an unsigned longword that is
    this pointer.

    If handle-address is specified, LIB$STAT_TIMER assumes that
    LIB$INIT_TIMER has been called with the same value of handle-
    address. Handle-address is an optional argument. If it is not
    specified, LIB$STAT_TIMER uses internal storage.