DSIV DPT GET DEMO (3347)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIV DPT GET DEMO
TAG DEM
ROUTINE DSIVDPT
RETURN VALUE TYPE ARRAY
AVAILABILITY AGREEMENT
DESCRIPTION
This will return specific patient demographic elements for a patient.
INPUT PARAMETER
  • DFN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   NO
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the patient's DFN or pointer (IEN) to the PATIENT file.
    
  • SSN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   10
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the patient's 9 (or 10) digit SSN.
     
    You must pass either DFN or SSN.
    
  • PERM
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   NO
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is a boolean flag (1 or 0). The default value is zero.
     
    If one, then always return the patient's permanent address information. 
    Otherwise return what is configured in the MAS software.
    
  • DSICONF
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   13
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    This flag determins whether or not to return the confidential address 
                            numbers are
                              1 for Eligibility/Enrollment
                              2 for Appointment/Scheduling
                              3 for Co-payments/Veterans Billing
                              4 for Medical Records
                              5 for All Others
     
            p2 - optional - fileman date to determine if confidential date is
                            effective.  Default value is TODAY
    information. It is optional. If this is passed, then TODAY will be 
    default date to use to check to see if a confidential address is active 
    for that date.
     
       DSICONF - optional - p1^p2
            p1 - required - confidential address category - this is a string 
    of
                            one or more numerics, e.g, 134, where category
    
  • DSIVFLG
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   1
    REQUIRED:   NO
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    This boolean value (1 or 0) will determine the data returned for certain
                    multiple ien value^county name
    data elements.  The default value is 0.  Any state, county or zip code
    data elements return value will be affected by this flag
     
      If DSIVFLG=0, return state abbreviation, a 5 or 9 zip-code, and county
                    name
     
      If DSIVFLG=1, return ien to file 5^state name^state abbreviation
                    internal form of zip code^external zip code
    
RETURN PARAMETER DESCRIPTION
On error return -1^error message
      5      sex
      6      date of death int;ext
      7      race
      8      religion
      9      marital status
     10      employment status
     11      1st st add
     12      2nd st add
     13      3rd st add
     14      city
 
     15      state abbr [or ien^state name^state abbr]
     16      zip (9 or 5) [or internal zip^external zip]
     17      county [or multiple ien^county name]
     18      home phone
     19      work phone
     20      LastName^FirstName^Middle^Suffix/Title
  ---- ret(21) - ret(28) all refer to confidential address  ----
     21      confidential address category bitmap.  Default value of
             "00000".  This is a 5 char string of 0s and 1s where each bit
             refers to whether or not the particular category is active or
 Else return:
             not as of the date in the DSICONF param.  Only those 
             categories requested in DSICONF param will have a bit value
             of 1
     22      street address 1
     23      street address 2
     24      street address 3
     25      city
     26      state abbr [or ien^state name^state abbr]
     27      zip (9 or 5) [or internal zip^external zip]
     28      county [or multiple ien^county name]
  DSIVDAT()  Description
  -------------------------------------------------------------
     29      primary elig ^ other elig ^ other elig ^ ...
     30      1 if patient is a veteran, else 0
     31      code^name of current means test status
           := file 5 ien^state name^state abbr [dsiflg=1]
   RET(26) := 5 char zip code or 9 digit zip code with dash [dsiflg=0]
           := internal zip code^external zip code [dsiflg=1]
   RET(27) := county name [dsiflg=0]
           := multiple ien value^county name [dsiflg=1]
   ***********************************************************************
  ---------  ------------------------------------------
   RET(28) := primary eligibility ^ other elig ^ other elig ^ ...
   RET(29) := 1 if patient is a veteran, else 0
   RET(30) := code^ name for current means test status
      1      patient name
      2      ssn;dashed ssn
      3      dob int;ext
      4      age