Arguments

 

id

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

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_IDENT 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_HOLDER_HIDDEN    Prevents someone from getting a list of
                          users who hold an identifier, unless they
                          own the identifier themselves.
   KGB$V_NAME_HIDDEN      Allows holders of an identifier to have it
                          translated-either from binary to ASCII or
                          vice versa-but prevents unauthorized users
                          from translating the identifier.
   KGB$V_NOACCESS         Makes any access rights of the identifier
                          null and void. This attribute is intended
                          as a modifier for a resource identifier or
                          the Subsystem attribute.
   KGB$V_RESOURCE         Allows holders of an identifier to charge
                          disk space to the identifier. It is used
                          only for file objects.
   KGB$V_SUBSYSTEM        Allows holders of the identifier to
                          create and 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_IDENT 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_HOLDER_HIDDEN    Prevents someone from getting a list of
                          users who hold an identifier, unless they
                          own the identifier themselves.
   KGB$V_NAME_HIDDEN      Allows holders of an identifier to have it
                          translated-either from binary to ASCII or
                          vice versa-but prevents unauthorized users
                          from translating the identifier.
   KGB$V_NOACCESS         Makes any access rights of the identifier
                          null and void. This attribute is intended
                          as a modifier for a resource identifier or
                          the Subsystem attribute.
   KGB$V_RESOURCE         Allows holders of an identifier to charge
                          disk space to the identifier. It is used
                          only for file objects.
   KGB$V_SUBSYSTEM        Allows holders of the identifier to
                          create and maintain protected subsystems
                          by assigning the Subsystem ACE to the
                          application images in the subsystem.
 

new_name

   OpenVMS usage:char_string
   type:         character-coded text string
   access:       read only
   mechanism:    by descriptor-fixed-length string descriptor
   New name to be given to the specified identifier. The new_
   name argument is the address of the descriptor pointing to the
   identifier name string.

   An identifier name consists of 1 to 31 alphanumeric characters,
   including dollar signs ($)  and underscores (_), and must contain
   at least one nonnumeric character. Any lowercase characters
   specified are automatically converted to uppercase.
 

new_value

   OpenVMS usage:rights_id
   type:         longword (unsigned)
   access:       read only
   mechanism:    by value
   New value to be assigned to the specified identifier. The new_
   value argument is a longword containing the binary value of the
   specified identifier. When the identifier value is changed, $MOD_
   IDENT also changes the value of the identifier in all of the
   holder records in which the specified identifier appears.