Arguments

 

pidadr

   OpenVMS usage:process_id
   type:         longword (unsigned)
   access:       modify
   mechanism:    by reference
   Process identification (PID) number of the process affected when
   $GRANTID completes execution. The pidadr argument is the address
   of a longword containing the PID of the process to be affected.
   You use -1 to indicate the system rights list. When pidadr is
   passed, it is also returned; therefore, you must pass it as a
   variable rather than a constant. If you specify neither pidadr
   nor prcnam, your own process is used.
 

prcnam

   OpenVMS usage:process_name
   type:         character-coded text string
   access:       read only
   mechanism:    by descriptor-fixed-length string descriptor
   Process name on which $GRANTID operates. The prcnam argument
   is the address of a character string descriptor containing the
   process name. The maximum length of the name is 15 characters.
   Because the UIC group number is interpreted as part of the
   process name, you must use pidadr to specify the rights list
   of a process in a different group. If you specify neither pidadr
   nor prcnam, your own process is used.
 

id

   OpenVMS usage:rights_holder
   type:         quadword (unsigned)
   access:       modify
   mechanism:    by reference
   Identifier and attributes to be granted when $GRANTID completes
   execution. The id argument is the address of a quadword
   containing the binary identifier code to be granted in the first
   longword and the attributes in the second longword.

   Use the id argument to modify the attributes of the identifier.

   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 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
                          database using the DCL command SET RIGHTS_
                          LIST.
   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.

   You must specify either id or name. Because the id argument is
   returned as well as passed if you specify name, you must pass it
   as a variable rather than a constant in this case.
 

name

   OpenVMS usage:char_string
   type:         character-coded text string
   access:       read only
   mechanism:    by descriptor-fixed-length string descriptor
   Name of the identifier granted when $GRANTID completes execution.
   The name argument is the address of a descriptor pointing to
   the name of the identifier. The identifier is granted as it is
   created. You must specify either id or name.
 

prvatr

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       write only
   mechanism:    by reference
   Previous attributes of the identifier. The prvatr argument is
   the address of a longword used to store the attributes of the
   identifier if it was previously present in the rights list. If
   you added rather than modified the identifier, prvatr is ignored.