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

    The Initialize Times and Counts routine stores the current
    values of specified times and counts for use by LIB$SHOW_TIMER
    or LIB$STAT_TIMER.

    Format

      LIB$INIT_TIMER  [context]

1 - Returns

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

2 - Argument

 context

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference

    Context variable that retains the values of the times and counts.
    The context argument contains the address of an unsigned longword
    that is this context. When you call LIB$INIT_TIMER, you must
    use the optional context argument only if you want to maintain
    several sets of statistics simultaneously.

    o  If context is omitted, the control block is allocated in
       static storage. This method is not AST reentrant.

    o  If context is zero, a control block is allocated in dynamic
       heap storage. The times and counts will be stored in that
       block and the address of the block returned in context. This
       method is fully reentrant and modular.

    o  If context is nonzero, it is considered to be the address of
       a control block previously allocated by a call to LIB$INIT_
       TIMER. If so, the control block is reused, and fresh times and
       counts are stored in it.

    When LIB$INIT_TIMER returns, the block of storage referred to by
    context will contain the times and counts.