SDEC PTSET (3580)    REMOTE PROCEDURE (8994)

SET patient demographics

• INP
  PARAMETER TYPE:   REFERENCE
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  all input except DFN is optional
              "2;;1|@12|13;;1" will add/update 2 & 13 and delete 12
     INP(3) = ETHNICITY - Note that the ETHNICITY INFORMATION multiple
                          only allows 1 entry.
                     input contains the following ;; pieces:
           1. ETHNICITY INFORMATION - pointer to the ETHNICITY file 10.2
                                      @ will delete
           2. METHOD OF COLLECTION - pointer to the
                                   ETHNICITY COLLECTION METHOD file 10.3
            '@4;;1' or just '@' will delete;  '5;;1' will add 5;
     INP(4) = ADDRESS1 - Street Address (Line 1) Free text
     INP(1) = DFN - (required) pointer to PATIENT file
                         3-30 characters
                         @ will delete the existing entry
     INP(5) = ADDRESS2 - Street Address (Line 2) Free text
                         3-30 characters
                         @ will delete the existing entry
     INP(6) = ADDRESS3 - Street Address (Line 3) Free text
                         3-30 characters
                         @ will delete the existing entry
     INP(7) = ZIP CODE - Zip+4 Free text of 5 or 9 digits
                         This populates fields .116 and .1112
     INP(2) = RACE - pointer to the RACE file 10 separated by |
     INP(8) = CITY - Free text 2-15 characters
     INP(9) = STATE - pointer to STATE file 5
     INP(10) = COUNTRY - pointer to COUNTRY CODE file 779.004
     INP(11) = BAD ADDRESS INDICATOR - Valid Values:
                   UNDELIVERABLE
                   HOMELESS
                   OTHER
                   ADDRESS NOT FOUND
                   @ will delete the existing entry
     INP(12) = PHONE (RESIDENCE) - free text 4-20 characters
              Each pipe piece contains the following pieces
                                   @ will delete the existing entry
     INP(13) = PHONE (WORK) - free text 4-20 characters
                              @ will delete the existing entry
     INP(14) = COUNTY name - name of a county from the COUNTY multiple
                             in the STATE file (#5)
     INP(15) = PHONE NUMBER [CELLULAR] 4-20 characters
                             @ will delete the existing entry
     INP(16) = Patient Email Address - 3-50 characters containing 1 @
                     A single character @ will delete the existing entry
     INP(17) = Marital Status - pointer to MARITAL STATUS file (#11)
             (Race1;;Method1|Race2;;Method2):
     INP(18) = Religious Preference - pointer to RELIGION file (#13)
     INP(19) = Patient Temporary Address Active? (.12105) Y:YES N:NO
               Temporary Address data can only be edited if INP(19) is
              'Y' or the 'TEMPORARY ADDRESS ACTIVE?' field is already
              defined as 'Y'.
     INP(20) = Patient Temporary Address Line 1 (.1211)
               @ will delete the existing entry
     INP(21) = Patient Temporary Address Line 2 (.1212)
               @ will delete the existing entry
     INP(22) = Patient Temporary Address Line 3 (.1213)
               RACE INFORMATION - pointer to the RACE file 10
               @ will delete the existing entry
     INP(23) = Patient Temporary City (.1214)
     INP(24) = Patient Temporary State (.1215)
     INP(25) = Patient Temporary Zip (.1216)
               [[***Don't use - INP(26) populates both***]]
     INP(26) = Patient Temporary Zip+4 (.12112)
               Populates fields .1216 and .12112
     INP(27) = Patient Temporary Country (.1223)
     INP(28) = Patient Temporary County (.12111)
     INP(29) = Patient Temporary Phone (.1219)
                                 Use @ to delete
                       (also referred to as Phone #2)
                       @ will delete the existing entry
     INP(30) = Patient Temporary Address Start Date (.1217) in external
               format (no time)
               @ will delete the existing entry
     INP(31) = Patient Temporary Address End Date (.1218) in external
               format (no time)
               @ will delete the existing entry
               METHOD OF COLLECTION - pointer to the RACE AND ETHNICITY
                                      COLLECTION METHOD file 10.3
  

 ; Successful Return:
generated
 ;     text back to the client.
 ;   Single Value return in the format "0^"
 ; Caught Exception Return:
 ;   A single entry in the Global Array in the format "-1^<error text>"
 ;   "T00020RETURNCODE^T00100TEXT"
 ; Unexpected Exception Return:
 ;     Handled by the RPC Broker.
 ;     M errors are trapped by the use of M and Kernel error handling.
 ;     The RPC execution stops and the RPC Broker sends the error