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.