VMS Help  —  System Services, $PERSONA FIND (Alpha and Integrity servers)
    On Alpha and Integrity server systems, enables the caller to find
    the personae within a process that have certain attributes or
    settings.

    Format

      SYS$PERSONA_FIND  persona ,itmlst ,contxt

    C Prototype

      int sys$persona_find  (unsigned int *persona, void *itmlst,

                            unsigned int *contxt);

1  –  Arguments

 persona

    OpenVMS usage:persona
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference
    Address of a longword into which the persona identification that
    matches all of the items present in the item list is written.

 itmlst

    OpenVMS usage:item_list_3
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference
    Attributes specifying which information about the persona is
    to be compared. The itmlst argument is the address of a list of
    item descriptors, each describing an item of information or an
    item list processing directive. The list of item descriptors is
    terminated by a longword value of 0.

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

 contxt

    OpenVMS usage:context
    type:         longword (unsigned)
    access:       modify
    mechanism:    by reference
    Context value used when repeatedly calling $PERSONA_FIND. The
    contxt argument is the address of a longword used while $PERSONA_
    FIND searches for all personae that match the criteria. The
    context value must be initialized to zero, and the resulting
    context of each call to $PERSONA_FIND must be presented to each
    subsequent call. After contxt is passed to $PERSONA_FIND, you
    must not modify its value.
Close Help