handle-address OpenVMS usage:address type: longword (unsigned) access: read only mechanism: by reference Block of storage containing the value returned by a previous call to LIB$INIT_TIMER. The handle-address argument is the address of an unsigned longword integer containing that value. o If specified, the pointer must be the same value returned by a previous call to LIB$INIT_TIMER. o If omitted, LIB$SHOW_TIMER will use a block of memory allocated by LIB$INIT_TIMER. o If handle-address is omitted and LIB$INIT_TIMER has not been called previously, the error LIB$_INVARG is returned. LIB$INIT_TIMER must be called prior to a call to LIB$SHOW_ TIMER. Note that the handle-address argument is the same as the context argument used in the LIB$INIT_TIMER call. LIB$SHOW_TIMER assumes that LIB$INIT_TIMER has been previously called, and that the results of that call are stored either in a block pointed to by handle-address, or in the memory allocated by LIB$INIT_TIMER. code OpenVMS usage:longword_signed type: longword (signed) access: read only mechanism: by reference Integer specifying the statistic you want; if it is omitted or zero, all five statistics are returned on one line. The code argument is the address of a signed longword integer containing the statistic code. The following values are allowed for the code argument: Value Description 1 Elapsed time 2 CPU time 3 Buffered I/O 4 Direct I/O 5 Page faults user-action-procedure OpenVMS usage:procedure type: procedure value access: function call (before return) mechanism: by value User-supplied action routine called by LIB$SHOW_TIMER. The default action of LIB$SHOW_TIMER is to write the results to SYS$OUTPUT. An action routine is useful if you want to write the results to a file or, in general, anywhere other than SYS$OUTPUT. The action routine returns either a success or failure condition value; this status is returned to the calling program as the value of LIB$SHOW_TIMER. user-argument-value OpenVMS usage:user-arg type: longword (unsigned) (on VAX systems) quadword (unsigned) (on Alpha and I64 systems) access: read only mechanism: by value A value to be passed to the action routine without interpretation. If omitted, LIB$SHOW_TIMER passes a zero by value to the user routine.