On Alpha and Integrity server systems, 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);
1 – 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.