Arguments

 

pidadr

   OpenVMS usage:process_id
   type:         longword (unsigned)
   access:       modify
   mechanism:    by reference
   Process identification (PID) number of the process affected when
   $REVOKID 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.
 

prcnam

   OpenVMS usage:process_name
   type:         character-coded text string
   access:       read only
   mechanism:    by descriptor-fixed-length string descriptor
   Process name on which $REVOKID 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.
 

id

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

   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 unprivileged 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_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 removed when $REVOKID completes execution.
   The name argument is the address of a descriptor pointing to the
   name of the identifier.
 

prvatr

   OpenVMS usage:mask_longword
   type:         longword (unsigned)
   access:       write only
   mechanism:    by reference
   Attributes of the deleted identifier. The prvatr argument is
   the address of a longword used to store the attributes of the
   identifier.