VMS Help System Services, $FIND HOLDER  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Returns the holder of a specified identifier.

    Format

      SYS$FIND_HOLDER  id ,[holder] ,[attrib] ,[contxt]

    C Prototype

      int sys$find_holder  (unsigned int id, struct _generic_64

                           *holder, unsigned int *attrib, unsigned

                           int *contxt);

1 - 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 on SET RIGHTS_LIST, refer to the
                    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.