ROR PATIENT GET DATA (1795)    REMOTE PROCEDURE (8994)

Name Value
NAME ROR PATIENT GET DATA
TAG GETPTDAT
ROUTINE RORRP021
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The ROR GET PATIENT DATA remote procedure returns patient's data from the 
PATIENT file and (optionally) the registry record.
INPUT PARAMETER
  • PATIEN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    A valid patient IEN (DFN) should be assigned to the PATIEN parameter.
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Flags that control the execution (can be combined):
    ignored.
     
      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
    
  • REGIEN
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    The 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.
    
RETURN PARAMETER DESCRIPTION
A negative value of the first "^"-piece of the Results[0] indicates that 
  Results[i]            Error Descriptor
                        (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
                          ^01: Error code
                            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
                          ^02: Message
                          ^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
                          ^03: Place of the error
                          ^05: Date (FileMan)
                          ^06: Location IEN  (Institution IEN)
                          ^07: Location Name (Institution Name)
                          ^08: Short Description
 
Otherwise, zero is returned in the Results[0] and subsequent nodes 
contain the patient's data.
 
  Results[0]            0
 
an error occurred during the execution of the remote procedure. In this 
  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)
 
case, the second piece of the Results[0] will contain number of the error
  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
descriptors returned in the subsequent nodes of the Results array:
                          ^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
  Results[0]            Result Descriptor
                          2106-3  White
 
                        Collection Method HL7 Values
                          OBS     Observer
                          PRX     Proxy
                          SLF     Self Identification
                          UNK     Unknown
 
  Results[i]            Ethnicity Information
                          ^01: "ETN"
                          ^01: The last error code
                          ^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
                          ^02: Number of the error descriptors
                          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