Arguments

 

id

   OpenVMS usage:rights_id
   type:         longword (unsigned)
   access:       read only
   mechanism:    by value
   Binary identifier value translated by $IDTOASC. The id argument
   is a longword containing the binary value of the identifier. To
   determine the identifier names of all identifiers in the rights
   database, you specify id as -1 and call $IDTOASC repeatedly until
   it returns the status code SS$_NOSUCHID. The identifiers are
   returned in alphabetical order.
 

namlen

   OpenVMS usage:word_unsigned
   type:         word (unsigned)
   access:       write only
   mechanism:    by 32- or 64-bit reference (Alpha and Integrity
                 servers)
   Number of characters in the identifier name translated by
   $IDTOASC. The namlen argument is the 32- or 64-bit address (on
   Alpha and Integrity server systems) of a word containing the
   length of the identifier name written to nambuf.
 

nambuf

   OpenVMS usage:char_string
   type:         character-coded text string
   access:       write only
   mechanism:    by 32- or 64-bit descriptor-fixed-length string
                 descriptor (Alpha and Integrity servers)
   Identifier name text string returned when $IDTOASC completes the
   translation. The nambuf argument is the 32- or 64-bit address (on
   Alpha and Integrity server systems) of a descriptor pointing to
   the buffer in which the identifier name is written.
 

resid

   OpenVMS usage:rights_id
   type:         longword (unsigned)
   access:       write only
   mechanism:    by 32- or 64-bit reference (Alpha and Integrity
                 servers)
   Identifier value of the identifier name returned in nambuf.
   The resid argument is the 32- or 64-bit address (on Alpha and
   Integrity server systems) of a longword containing the 32-bit
   code of the identifier.
 

attrib

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       write only
   mechanism:    by by 32- or 64-bit reference (Alpha and Integrity
                 servers)
   Mask of attributes associated with the identifier returned in
   resid. The attrib argument is the 32- or 64-bit address (on
   Alpha and Integrity server systems) 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 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 using the DCL command SET RIGHTS_
                          LIST.
   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.
 

contxt

   OpenVMS usage:context
   type:         longword (unsigned)
   access:       modify
   mechanism:    by 32- or 64-bit reference (Alpha and Integrity
                 servers)
   Context value used when repeatedly calling $IDTOASC. The contxt
   argument is the 32- or 64-bit address (on Alpha and Integrity
   server systems) of a longword used while $IDTOASC searches for
   all identifiers. The context value must be initialized to the
   value 0, and the resulting context of each call to $IDTOASC must
   be presented to each subsequent call. After contxt is passed to
   $IDTOASC, you must not modify its value.