Arguments

 

id

   OpenVMS usage:rights_id
   type:         longword (unsigned)
   access:       read only
   mechanism:    by value
   Binary identifier value whose holders are found by $FIND_HOLDER.
   The id argument is a longword containing the binary identifier
   value.
 

holder

   OpenVMS usage:rights_holder
   type:         quadword (unsigned)
   access:       write only
   mechanism:    by reference
   Holder identifier returned when $FIND_HOLDER completes execution.
   The holder argument is the address of a quadword containing
   the holder identifier. The first longword contains the UIC of
   the holder with the high-order word containing the group number
   and the low-order word containing the member number. The second
   longword contains the value 0.
 

attrib

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       write only
   mechanism:    by reference
   Mask of attributes associated with the holder record specified
   by holder. The attrib argument is the address of a longword
   containing the attribute mask.

   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. For more
                   information about SET RIGHTS_LIST, see the VSI
                   OpenVMS DCL Dictionary.

   KGB$V_          Makes any rights of the identifier null and void.
   NOACCESS        This attribute is intended as a modifier for a
                   resource identifier or the Subsystem attribute.

   KGB$V_          Allows the holder of an identifier to charge disk
   RESOURCE        space to the identifier. It is used only for file
                   objects.

   KGB$V_          Allows holders of an 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 while searching for all the holders of the
   specified identifier when executing $FIND_HOLDER. The contxt
   argument is the address of a longword containing the context
   value. When calling $FIND_HOLDER repeatedly, contxt must be
   set initially to 0 and the resulting context of each call to
   $FIND_HOLDER must be presented to each subsequent call. After
   the argument is passed to $FIND_HOLDER, you must not modify its
   value.