/sys$common/syshlp/helplib.hlb System Services, $PERSONA CREATE (Alpha Only)  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Creates a persona that can be assumed using the $PERSONA_ASSUME
    service.

    Format

      SYS$PERSONA_CREATE  persona ,[usrnam] ,[flags], [usrpro],

                          [itmlst]

    C Prototype

      int sys$persona_create  (unsigned int *persona, void *usrnam,

                              unsigned int flags, unsigned int

                              *usrpro, unsigned int *itmlst);

    Arguments

 persona

    OpenVMS usage:persona
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Address of a longword into which the persona identification
    handle is written.

 usrnam

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

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The $ISSDEF macro defines these codes:

    o  ISS$V_CREATE_AUTHPRIV - This bit is used to create a persona
       with the privilege fields set to the authorized privileges of
       the specified user.

    o  ISS$V_CREATE_DEFPRIV - This bit is used for backward
       compatibility with the previous implementation of personae.
       This bit is accepted but not processed, as it describes the
       default behavior of the service.

    o  ISS$V_NOACCESS - Tells $PERSONA_CREATE not to access the
       SYSUAF file. Only valid in exec or kernel mode.

 usrpro

    OpenVMS usage:char_string
    type:         opaque byte stream
    access:       read only
    mechanism:    by descriptor
    Buffer containing an encoded security profile. The usrpro
    argument is the address of a descriptor pointing to a buffer
    that contains encoded security profile data. This profile can be
    created by calling the SYS$CREATE_USER_PROFILE system service.

 itmlst

    OpenVMS usage:item_list_3
    type:         longword
    access:       read only
    mechanism:    by reference
    Attributes describing modifications to the security profile. The
    itmlst argument is the address of an item_list defining changes
    to be made to the specified user profile.