HELPLIB.HLB  —  System Services, $REVOKID
    Removes the specified identifier from the rights list of the
    process or the system. If the identifier is listed as a holder
    of any other identifier, the appropriate holder records are also
    deleted.

    Format

      SYS$REVOKID  [pidadr] ,[prcnam] ,[id] ,[name] ,[prvatr]

    C Prototype

      int sys$revokid  (unsigned int *pidadr, void *prcnam, struct

                       _generic_64 *id, void *name, unsigned int

                       *prvatr, unsigned int segment);

1  –  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.
Close Help