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

    Modifies the specified holder record of the target identifier in
    the rights database.

    Format

      SYS$MOD_HOLDER  id ,holder ,[set_attrib] ,[clr_attrib]

    C Prototype

      int sys$mod_holder  (unsigned int id, struct _generic_64

                          *holder, unsigned int set_attrib, unsigned

                          int clr_attrib);

1 - Arguments

 id

    OpenVMS usage:rights_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Binary value of target identifier whose holder record is modified
    when $MOD_HOLDER completes execution. The id argument is a
    longword containing the identifier value.

 holder

    OpenVMS usage:rights_holder
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by reference
    Identifier of holder being modified when $MOD_HOLDER completes
    execution. The holder argument is the address of a quadword
    containing the UIC identifier of the holder in the first longword
    and the value of 0 in the second longword.

 set_attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Bit mask of attributes to be enabled for the identifier when
    $MOD_HOLDER completes execution. The set_attrib argument is a
    longword containing the attribute mask.

    The attributes actually enabled are the intersection of those
    specified and the attributes of the identifier. If you specify
    the same attribute in set_attrib and clr_attrib, the attribute is
    enabled.

    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 following symbols
    for each bit position are defined in the system macro library
    ($KGBDEF):

    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.

 clr_attrib

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Bit mask of attributes to be disabled for the identifier when
    $MOD_HOLDER completes execution. The clr_attrib argument is a
    longword containing the attribute mask.

    If you specify the same attribute in set_attrib and clr_attrib,
    the attribute is enabled.

    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 following symbols
    for each bit position are defined in the system macro library
    ($KGBDEF):

    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.