VMS Help System Services, $PERSONA CREATE (VAX 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

    C Prototype

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

                              unsigned int flags);

    Arguments

 persona

    OpenVMS usage:integer
    type:         longword (unsigned)
    access:       write
    mechanism:    by reference
    Address of a longword into which the persona 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
    12 alphanumeric characters.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Flag mask specifying which Persona services options are to be
    employed when the persona is created.

    The following table describes each flag:

    Flag                   Description

    IMP$M_ASSUME_DEFPRIV   Create a persona with only default
                           privileges.
    IMP$M_ASSUME_          Create a persona with default
    DEFCLASS               classification.