VMS Help System Services, $GET GALAXY LOCK INFO (Alpha Only)  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Returns "interesting" fields from the specified lock.

    Note that this system service is supported only in an OpenVMS
    Alpha Galaxy environment. For more information about programming
    with OpenVMS Galaxy system services, refer to the OpenVMS Alpha
    Partitioning and Galaxy Guide.

    Format

      SYS$GET_GALAXY_LOCK_INFO  handle ,name ,timeout ,size ,ipl

                                ,rank ,flags [,name_length]

    C Prototype

      int sys$get_galaxy_lock_info  (unsigned __int64 lock_handle,

                                    char *name, unsigned int

                                    *timeout, unsigned int *size,

                                    unsigned int *ipl, unsigned int

                                    *rank, unsigned short int *flags

                                    unsigned short int *name_length);

    Arguments

 handle

    OpenVMS usage:handle for the galaxy lock
    type:         quadword (unsigned)
    access:       read
    mechanism:    input by value
    The 64-bit lock handle that identifies the lock on which to
    return information. This value is returned by SYS$CREATE_GALAXY_
    LOCK.

 name

    OpenVMS usage:address
    type:         zero-terminated string
    access:       write
    mechanism:    output by reference
    Pointer to a buffer. This buffer must be large enough to receive
    the name of the lock. Locks names are zero-terminated strings
    with a maximum size of 16 bytes.

 timeout

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       write
    mechanism:    output by reference
    Pointer to a longword. The value returned is the timeout value of
    the lock.

 size

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       write
    mechanism:    output by reference
    Pointer to a longword. The value returned is the size of the lock
    in bytes.

 ipl

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       write
    mechanism:    output by reference
    Pointer to a longword. The value returned is the IPL of the lock.

 rank

    OpenVMS usage:address
    type:         longword (unsigned)
    access:       write
    mechanism:    output by reference
    Pointer to a longword. The value returned is the rank of the
    lock.

 flags

    OpenVMS usage:address
    type:         word (unsigned)
    access:       write
    mechanism:    output by reference
    Pointer to a word. The value returned is the word mask of lock
    flags.

 name_length

    OpenVMS usage:address
    type:         word (unsigned)
    access:       write
    mechanism:    output by reference
    Length of the string returned in the name argument.