Arguments

 

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.