VMS Help System Services, $PERSONA FIND (Alpha Only)  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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 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.