VMS Help
System Services, $FIND HELD
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
|
Returns the identifiers held by a specified holder.
Format
SYS$FIND_HELD holder ,[id] ,[attrib] ,[contxt]
C Prototype
int sys$find_held (struct _generic_64 *holder, unsigned int
*id, unsigned int *attrib, unsigned int
*contxt);
holder
OpenVMS usage:rights_holder
type: quadword (unsigned)
access: read only
mechanism: by reference
Holder whose identifiers are to be found when $FIND_HELD
completes execution. The holder argument is the address of a
quadword data structure containing the holder identifier. This
quadword data structure consists of a longword containing the
holder UIC, followed by a longword containing the value 0.
id
OpenVMS usage:rights_id
type: longword (unsigned)
access: write only
mechanism: by reference
Identifier value found when $FIND_HELD completes execution.
The id argument is the address of a longword containing the
identifier value with which the holder is associated.
attrib
OpenVMS usage:mask_longword
type: longword (unsigned)
access: write only
mechanism: by reference
Attributes associated with the holder returned in id when $FIND_
HELD completes execution. The attrib argument is the address of a
longword containing a bit mask specifying the attributes.
Symbol values are offsets to the bits within the longword. You
can also obtain the values as masks with the appropriate bit set
using the prefix KGB$M rather than KGB$V. The symbols are defined
in the system macro library ($KGBDEF). The following are the
symbols for each bit position:
Bit Position Meaning When Set
KGB$V_DYNAMIC Allows holders of the identifier to remove it
from or add it to the process rights list by
using the DCL command SET RIGHTS_LIST.
KGB$V_ Makes any access rights of the identifier
NOACCESS null and void. This attribute is intended as
a modifier for a resource identifier or the
Subsystem attribute.
KGB$V_ Allows the holder to charge resources, such as
RESOURCE disk blocks, to the identifier.
KGB$V_ Allows holders of the identifier to create and
SUBSYSTEM maintain protected subsystems by assigning the
Subsystem ACE to the application images in the
subsystem.
contxt
OpenVMS usage:context
type: longword (unsigned)
access: modify
mechanism: by reference
Context value used when repeatedly calling $FIND_HELD. The contxt
argument is the address of a longword used while searching for
all identifiers. The context value must be initialized to 0,
and the resulting context of each call to $FIND_HELD must be
presented to each subsequent call. After contxt is passed to
$FIND_HELD, you must not modify its value.
[legal]
[privacy]
[GNU]
[policy]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.