VMS Help System Services, $GRANTID  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Adds the specified identifier record to the rights list of the
    process or the system.

    Format

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

    C Prototype

      int sys$grantid  (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
    $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.