SDEC PTSET (3580)    REMOTE PROCEDURE (8994)

Name Value
NAME SDEC PTSET
TAG PTSET
ROUTINE SDEC
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
WORD WRAP ON FALSE
DESCRIPTION
SET patient demographics
INPUT PARAMETER
  • 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
    
RETURN PARAMETER DESCRIPTION
 ; 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