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