Arguments

 

name

   OpenVMS usage:char_string
   type:         character-coded text string
   access:       read only
   mechanism:    by 32- or 64-bit descriptor-fixed-length string
                 descriptor
   Identifier name translated when $ASCTOID completes execution. The
   name argument is the 32- or 64-bit address of a character-string
   descriptor pointing to the identifier name.
 

id

   OpenVMS usage:rights_id
   type:         longword (unsigned)
   access:       write only
   mechanism:    by 32- or 64-bit reference
   Identifier value resulting when $ASCTOID completes execution. The
   id argument is the 32- or 64-bit address of a longword in which
   the identifier value is written.
 

attrib

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       write only
   mechanism:    by 32- or 64-bit reference
   Attributes associated with the identifier returned in id when
   $ASCTOID completes execution. The attrib argument is the 32- or
   64-bit address of a longword containing a bit mask specifying the
   attributes.

   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 $KGBDEF library. The symbolic names for each
   bit position are listed in the following table:

   Bit Position           Meaning When Set

   KGB$V_DYNAMIC          Allows holders of the identifier to remove
                          it from or add it to the process rights
                          database 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. Special
                          privilege is required to translate hidden
                          names.
   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. Special
                          privilege is required to translate hidden
                          names.
   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 the holder to charge resources,
                          such as disk blocks, to the identifier.
   KGB$V_SUBSYSTEM        Allows holders of the identifier to create
                          and maintain protected subsystems by
                          assigning the Subsystem access control
                          entry (ACE) to the application images in
                          the subsystem.