Acquires ownership of an OpenVMS Galaxy 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, see the VSI OpenVMS Alpha Partitioning and Galaxy Guide.

    Format

      SYS$ACQUIRE_GALAXY_LOCK  handle ,timeout ,flags

    C Prototype

      int sys$acquire_galaxy_lock  (unsigned __int64 lock_handle,

                                   unsigned int timeout, unsigned int

                                   flags);

1  –  Arguments

 handle

    OpenVMS usage:galaxy lock handle
    type:         quadword (unsigned)
    access:       read
    mechanism:    input by value
    The 64-bit lock handle that identifies the lock to be acquired.
    This value is returned by SYS$CREATE_GALAXY_LOCK.

 timeout

    OpenVMS usage:wait timeout
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    The 32-bit wait or spin timeout specified in 10 microsecond
    units. If not specified, defaults to 10 microseconds.

 flags

    OpenVMS usage:bit mask
    type:         longword (unsigned)
    access:       read
    mechanism:    input by value
    Control flags defined by the GLOCKDEF macro: GLOCK$C_NOBREAK,
    GLOCK$C_NOSPIN, and GLOCK$C_NOWAIT.