ROR PATIENT GET DATA

TITLEVALUE
NAMEROR PATIENT GET DATA
DESCRIPTIONThe ROR GET PATIENT DATA remote procedure returns patient's data from the
PATIENT file and (optionally) the registry record.
TAGGETPTDAT
ROUTINERORRP021
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERPATIEN
DESCRIPTIONA valid patient IEN (DFN) should be assigned to the PATIEN parameter.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERFLAGS
DESCRIPTIONFlags that control the execution (can be combined):

A Load the patient's address
E Load the ethnicity information
L Load values of the registry local fields
R Load the race information
S Load the patient's selection rules

The "L" and "S" flags require the REGIEN parameter. Otherwise, they are
ignored.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERREGIEN
DESCRIPTIONThe REGIEN parameter should contain a valid registry IEN (IEN of the
registry parameters record in the ROR REGISTRY PARAMETERS file #798.1).

If this parameter is defined and its value is greater than 0 then the
"PRD" segment with the basic patient's registry data will be returned.
If the patient is not in the registry then an empty "PRD" segment will
be returned anyway.
PARAMETER TYPELITERAL
REQUIRED
MAXIMUM DATA LENGTH
RETURN VALUE TYPEARRAY
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, zero is returned in the Results[0] and subsequent nodes
contain the patient's data.

Results[0] 0

Results[i] Demographic Information
^01: "DEM"
^02: ""
^03: Patient IEN (DFN)
^04: Patient Name
^05: Date of Birth (FileMan)
^06: SSN
^07: Date of Death (FileMan)
^08: Sex (F/M)

Results[i] Patient's Address
^01: "ADR"
^02: ""
^03: Address (1)
^04: Address (2)
^05: Address (3)
^06: City
^07: State (IEN)
^08: State (Name)
^09: ZIP
^10: ZIP+4
^11: County (IEN)
^12: County (Name)
^13: Home Phone

Results[i] Race Information
^01: "RCE"
^02: Race IEN
^03: Race HL7 Value
^04: Race
^05: Collection Method HL7 Value
^06: Collection Method

Race HL7 Values
1002-5 American Indian or Alaska Native
2028-9 Asian
2054-5 Black or African American
0000-0 Declined to Answer
2076-8 Native Hawaiian or Pacific Islander
9999-4 Unknown by Patient
2106-3 White

Collection Method HL7 Values
OBS Observer
PRX Proxy
SLF Self Identification
UNK Unknown

Results[i] Ethnicity Information
^01: "ETN"
^02: Ethnicity IEN
^03: Ethnicity HL7 Value
^04: Ethnicity
^05: Collection Method HL7 value
^06: Collection Method

Ethnicity HL7 Values
0000-0 Declined to Answer
2135-2 Hispanic or Latino
2186-5 Not Hispanic or Latino
9999-4 Unknown by Patient

Results[i] Patient's Registry Data
^01: "PRD"
^02: ""
^03: Date Entered (FileMan)
^04: Status Code (Field 3, File #798)
^05: Active (0/1)
^06: Do not Send (0/1)
^07: Data Acknowledged Until (FileMan)
^08: Data Extracted Until (FileMan)
^09: Date Selected (FileMan)
^10: Date Confirmed (FileMan)
^11: Location Selected (Institution Name)
^12: Selection Rule Description
^13: reserved
^14: reserved
^15: Action Flags (see the description below)

The Status field can have the following values
(see description of the STATUS field of the
ROR REGISTRY RECORD file for more details):
0 Confirmed
4 Pending
5 Deleted

The Action Flags field indicates the actions that
can be performed on the patient's record:
C CDC form can be edited/printed
D The record can be deleted
E The record can be edited
O Read-only mode

Results[i] Local field data
^O1: "LFV"
^02: IEN in the LOCAL FIELD multiple
of the ROR REGISTRY RECORD file
^03: Field Definition IEN
(in the ROR LOCAL FIELD file)
^04: Field Name
^05: Date (FileMan)
^06: Comment

Results[i] Selection Rule
^01: "PSR"
^02: IEN in the SELECTION RULE multiple
of the ROR REGISTRY RECORD file
^03: Rule Definition IEN
(in the ROR SELECTION RULE file)
^04: Name of the Rule
^05: Date (FileMan)
^06: Location IEN (Institution IEN)
^07: Location Name (Institution Name)
^08: Short Description
AVAILABILITYRESTRICTED
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION1
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED