RORICR PATIENT LOAD (1803)    REMOTE PROCEDURE (8994)

Name Value
NAME RORICR PATIENT LOAD
TAG LOAD
ROUTINE RORRP033
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The RORICR PATIENT LOAD remote procedure loads the patient's data from the
ICR registry and prepares the record for editing.
INPUT PARAMETER
  • REGIEN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    The REGIEN parameter should contain a valid registry IEN (IEN of the
    registry parameters record in the ROR REGISTRY PARAMETERS file #798.1).
    
  • PATIEN
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    A valid patient IEN (DFN) should be assigned to the PATIEN parameter.
    
  • LOCK
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    If this parameter is defined and not zero then the RPC will try to lock
    the registry record before loading the data and will leave it locked.
    
RETURN PARAMETER DESCRIPTION
A negative value of the first "^"-piece of the Results[0] indicates that
  Results[i]            Error Descriptor
  Results[i]            Patient History (risk factors)
                          ^01: "PH"
                          ^02: ""
                          ^03: SEX RELATIONS W/MALE PARTNER   {0|1|9}
                          ^04: SEX RELATIONS W/FEMALE PARTNER {0|1|9}
                          ^05: IV DRUGS AFTER 77 AND PRE HIV  {0|1|9}
                          ^06: REC'D CLOTTING FACTORS         {0|1|9}
                          ^07: TYPE OF HEMOPHILIA             {1|2|8}
                          ^08: OTHER HEMOPHILIA DESCRIPTION
                          ^09: SR WITH IV DRUG USER           {0|1|9}
                          ^01: Error code
                          ^10: SR WITH BISEXUAL MAN           {0|1|9}
                          ^11: SR W HEMOPHILIA/COAG DISORDER  {0|1|9}
                          ^12: SR W TRANS RECIPIENT WITH AIDS {0|1|9}
                          ^13: TRANSPLANT RECIP-DOCUMNTD HIV  {0|1|9}
                          ^14: SR W AIDS/HIV INFECTION        {0|1|9}
                          ^15: TRANS AFTER 77 AND BEFORE HIV  {0|1|9}
                          ^16: DATE OF FIRST TRANSFUSION      (MM/YY)
                          ^17: DATE OF LAST TRANSFUSION       (MM/YY)
                          ^18: TRANSPLANT OR ARTIF INSEMIN    {0|1|9}
                          ^19: WORK IN HEALTH CARE OR LAB     {0|1|9}
                          ^02: Message
                          ^20: OCCUPATION
 
  Results[i]            Registry Data
                          ^01: "ICR"
                          ^02: ""
                          ^03: Clinical AIDS                  {0|1}
                          ^04: Date of Clinical AIDS (FileMan)
                          ^05: reserved
                          ^06: Test name
                          ^07: Code of the group
                          ^03: Place of the error
                          ^08: Group name
 
  Results[i]            Registry Data
                          ^01: "ICR"
                          ^02: ""
                          ^03: Clinical AIDS                  {0|1}
                          ^04: Date of Clinical AIDS (FileMan)
                          ^05: Code of the Supporting Evidence
                          ^06: Date of last CD4 (FileMan)
                          ^07: Last CD4
 
                          ^08: Date of lowest CD4 (FileMan)
                          ^09: Lowest CD4
                          ^10: Date of lowest CD4 % (FileMan)
                          ^11: Lowest CD4 %
If locking was requested (see the LOCK parameter) and the record could not
be locked then the first "^"-piece of the Results[0] would be greater than
0. The Results[0] would contain the lock descriptor and subsequent nodes
of the global array would contain the data (see below). The lock 
descriptor contains information about the process, which owns the most 
an error occurred during the execution of the remote procedure. In this
recent lock of the record. The "O" flag (read-only) would also be added to
the 15th field of the "PRD" segment.
 
  Results[0]            Lock Descriptor
                          ^01: Date/Time (FileMan)
                          ^02: User/Process name
                          ^03: User IEN (DUZ)
                          ^04: $JOB
                          ^05: Task number
 
case, the second piece of the Results[0] will contain number of the error
THE DATA ARE LOADED ONLY FOR VIEWING PURPOSES (READ-ONLY)!
 
Otherwise, zero is returned in the Results[0] and the subsequent nodes of
the array contain the data.
 
  Results[0]            0
 
  Results[i]            Demographic Information
                          ^01: "DEM"
                          ^02: ""
descriptors returned in the subsequent nodes of the Results array:
                          ^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]            Basic 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
  Results[0]            Result Descriptor
                          ^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
                          ^01: The last error code
 
                        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: Number of the error descriptors
                          ^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