Modifies the user authorization file (UAF) record for a specified
    user.

    Format

      SYS$SETUAI  [nullarg] ,[contxt] ,usrnam ,itmlst ,[nullarg]

                  ,[nullarg] ,[nullarg]

    C Prototype

      int sys$setuai  (unsigned int efn, unsigned int *contxt, void

                      *usrnam, void *itmlst, struct _iosb *iosb, void

                      (*astadr)(__unknown_params), int astprm);

1  –  Arguments

 nullarg

    OpenVMS usage:null_arg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument Reserved to VSI.

 contxt

    OpenVMS usage:longword
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    A longword used to maintain authorization file context. The
    contxt argument is the address of a longword to receive a $SETUAI
    context value. On the initial call, this longword should contain
    the value -1. On subsequent calls, the value of the contxt
    argument from the previous call should be passed back in.

 usrnam

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Name of the user whose UAF record is modified. The usrnam
    argument is the address of a descriptor pointing to a character
    text string containing the user name. The user name string can
    contain a maximum of 32 alphanumeric characters.

 itmlst

    OpenVMS usage:item_list_3
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Item list specifying which information from the specified UAF
    record is to be modified. The itmlst argument is the address of a
    list of one or more item descriptors, each of which specifies an
    item code. The item list is terminated by the item code 0 or by
    the longword 0.

    To view the item code diagram and descriptor fields table, see
    the VSI OpenVMS System Services Reference Manual.

 nullarg

    OpenVMS usage:nullarg
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by reference
    Placeholding argument Reserved to VSI.

 nullarg

    OpenVMS usage:nullarg
    type:         procedure entry mask
    access:       call without stack unwinding
    mechanism:    by reference
    Placeholding argument Reserved to VSI.

 nullarg

    OpenVMS usage:nullarg
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Placeholding argument Reserved to VSI.