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

    (Alpha only.) The Show Virtual Memory Statistics routine returns
    the statistics accumulated from calls to LIB$GET_VM_64/LIB$FREE_
    VM_64 and LIB$GET_VM_PAGE_64/LIB$FREE_VM_PAGE_64.

    Format

      LIB$SHOW_VM_64  [code] [,user-action-procedure]

                      [,user-specified-argument]

1 - Returns

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

2 - Arguments

 code

    OpenVMS usage:quadword_signed
    type:         quadword integer (signed)
    access:       read only
    mechanism:    by reference

    Code specifying any one of the statistics to be written to
    SYS$OUTPUT or passed to an action routine for processing.
    The code argument is the address of a signed quadword integer
    containing the statistic code. This is an optional argument. If
    the statistic code is omitted or is zero, statistics for values
    1, 2, and 3 are returned on one line.

    The following values are allowed for the code argument:

    Value Statistic

    0     Statistics for values 1, 2, and 3 are returned.
    1     Number of successful calls to LIB$GET_VM_64.
    2     Number of successful calls to LIB$FREE_VM_64.
    3     Number of bytes allocated by LIB$GET_VM_64 but not yet
          deallocated by LIB$FREE_VM_64.
    4     Statistics for values 5, 6, and 7 are returned.
    5     Number of calls to LIB$GET_VM_PAGE_64.
    6     Number of calls to LIB$FREE_VM_PAGE_64.
    7     Number of Alpha pagelets allocated by LIB$GET_VM_PAGE_64
          but not yet deallocated by LIB$FREE_VM_PAGE_64.

 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_VM_64. By
    default, LIB$SHOW_VM_64 returns statistics to SYS$OUTPUT. An
    action routine is useful when you want to return statistics to
    a file or, in general, to any place other than SYS$OUTPUT. The
    routine returns either a success or failure condition value,
    which will be returned as the value of LIB$SHOW_VM_64.

 user-specified-argument

    OpenVMS usage:user_arg
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by value

    A 64-bit value to be passed directly to the action routine
    without interpretation. That is, the contents of the argument
    list entry user-specified-argument are copied to the argument
    list entry for user-action-procedure.