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

    Modifies the context of the current process to match the context
    of a given persona. The $PERSONA_ASSUME service allows an OpenVMS
    process to assume the identity of another user or to discard a
    persona to return the process to its original state.

    Format

      SYS$PERSONA_ASSUME  persona ,[flags]

    C Prototype

      int sys$persona_assume  (unsigned int *persona, unsigned int

                              flags);

    Arguments

 persona

    OpenVMS usage:integer
    type:         longword (unsigned)
    access:       read
    mechanism:    by reference
    Address of a longword in which the persona handle is expected.

    If the value of the context passed is 1, then the current persona
    is discarded, and the state of the calling process is returned
    to the state that existed prior to the first call to $PERSONA_
    CREATE.

 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 assumed. This argument is ignored
    when a persona is being discarded.

    The following table describes each flag:

    Flag                   Description

    IMP$M_ASSUME_SECURITY  Assume access rights, UIC, authorized
                           privileges, user name, and security audit
                           flag.
    IMP$M_ASSUME_ACCOUNT   Assume OpenVMS account.
    IMP$M_ASSUME_JOB_WIDE  Assume the new persona, even in a
                           multiprocess job.