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

    Returns authorization information about a specified user.

    Format

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

                  ,[nullarg] ,[nullarg]

    C Prototype

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

 usrnam

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by descriptor-fixed-length string descriptor
    Name of the user about whom $GETUAI returns authorization
    information. 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 12 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 user's
    user authorization file (UAF) record is to be returned. 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 an item code value of 0 or by a longword value
    of 0.

    Refer to the OpenVMS System Services Reference Manual to view the
    item code diagram and descriptor fields table.

 contxt

    OpenVMS usage:longword
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    On VAX systems, an optional longword used to maintain an open
    channel to the authorization file. The contxt argument is the
    address of a longword to receive a $GETUAI context value. If the
    contxt argument is specified on the initial call, this longword
    should contain the value -1, and on subsequent calls, the value
    of the contxt argument from the previous call should be passed
    back in.