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

    (Alpha only.) The Return Information About a Zone routine
    returns formatted information about a zone in the 64-bit virtual
    address space, detailing such information as the zone's name,
    characteristics, and areas, and then passes the information to
    the specified or default action routine.

    Format

      LIB$SHOW_VM_ZONE_64  zone-id [,detail-level]

                           [,user-action-procedure] [,user-arg]

1 - Returns

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

2 - Arguments

 zone-id

    OpenVMS usage:identifier
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by reference

    Zone identifier. The zone-id argument is the address of an
    unsigned quadword containing this identifier. Use zero to
    indicate the 64-bit default zone.

 detail-level

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

    An identifier code specifying the level of detail required
    by the user. The detail-level argument is the address of a
    signed quadword containing this code. The default is minimal
    information. The following are valid values for detail-level:

    0    zone-id and name
    1    zone-id, name, algorithm, flags, and size information
    2    zone-id, name, algorithm, flags, size information, cache
         information, and area summary
    3    zone-id, name, algorithm, flags, size information, cache
         information, area summary, and queue validation

 user-action-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    Optional user-supplied action routine called by LIB$SHOW_VM_
    ZONE_64. By default, LIB$SHOW_VM_ZONE_64 prints statistics
    to SYS$OUTPUT by means of LIB$PUT_OUTPUT. An action routine
    is useful when you want to return statistics to a file or, in
    general, to any location other than SYS$OUTPUT. If user-action-
    procedure fails, LIB$SHOW_VM_ZONE_64 terminates and returns a
    failure code. Success codes are ignored.

 user-arg

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

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