ROR LIST VISTA USERS

TITLEVALUE
NAMEROR LIST VISTA USERS
DESCRIPTIONThe ROR LIST VISTA USERS remote procedure returns a list of users from the
NEW PERSON file (#200).
TAGUSERLIST
ROUTINERORRP024
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERPART
DESCRIPTIONThe PART parameter defines the search pattern. It should contain the
beginning of the user's name.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERFLAGS
DESCRIPTIONFlags that control the execution (can be combined):

B Backwards. Traverses the index in the opposite
direction of normal traversal.

D Get default division for each user

P Select providers only (check for the PROVIDER
security key).
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERNUMBER
DESCRIPTIONMaximum number of entries to return. A value of "*" or no value in this
parameter designates all entries that conform the criteria.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERFROM
DESCRIPTIONThe index entry(s) from which to begin the list. Use the pieces of the
Results[0] (starting from the second one) to continue the listing in the
subsequent procedure calls.

NOTE: The FROM value itself is not included in the
resulting list.

See description of the LIST^DIC for more details about the PART, NUMBER
and FROM parameters.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONA negative value of the first "^"-piece of the Results[0] indicates that
an error occurred during the execution of the remote procedure. In this
case, the second piece of the Results[0] will contain number of the error
descriptors returned in the subsequent nodes of the Results array:

Results[0] Result Descriptor
^01: The last error code
^02: Number of the error descriptors

Results[i] Error Descriptor
^01: Error code
^02: Message
^03: Place of the error

Otherwise, number of VistA users and the value of the FROM parameter for
the next procedure call are returned in the Results[0] and the subsequent
nodes of the Results array contain the users.

Results[0] Result Descriptor
^01: Number of users
^02: Values that comprise the FROM parameter
^nn: for the subsequent call of the procedure

Results[i] VistA User
^01: IEN (DUZ)
^02: Name
^03: Office Phone
^04: Nickname
^06: Default Division IEN (only if D flag)
^07: Default Division Name (only if D flag)
AVAILABILITYRESTRICTED
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION1
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED