VMS Help
System Services, $GET GALAXY LOCK INFO (Alpha Only)
*Conan The Librarian
|
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 HP 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);
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.