DSSO DPT GET DEMO (4270)    REMOTE PROCEDURE (8994)

This RPC returns specific demographic elements for a patient.  The 
routine was cloned from DSICDPT1 with two fields being added to the
return:
VAEL(3) -List[30] - Eligibility Status - If the SERVICE CONNECTED? field
is YES, a "1" will be returned in the first piece; otherwise, a "0" will
be returned.  If service-connected, the SERVICE CONNECTED PERCENTAGE field
will be returned in the second piece.  (e.g., 1^70)
 
VAEL(7) - Claim Number - List[32]

• DSSODFN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   20
  REQUIRED:   NO
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This is the patient's DFN or pointer to the Patient file (#2).
   
  DFN or SSN must be passed.
  

• DSSOSSN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   10
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This is the patient's 9 (or 10) digit SSN.
   
  Either SSN or DFN are required. 
  

• DSSOPRM
  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 as configured in the MAS software.
  

• DSSOCNF
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   13
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  This flag determines whether or not to return the confidential address 
                           1 for Eligibility/Enrollment
                           2 for Appointment/Scheduling
                           3 for Copayments/Veterans Billing
                           4 for Medical Records
                           5 for All Others
   
         p2 - optional - Fileman date to determine if confidential date is
                         effective.  Default date is TODAY.
  information.  It is optional.  If this is passed, then TODAY will be the 
  default date to use to check to see if a confidential address is active 
  for that date.
   
    DSSOCNF - optional - p1^p2
         p1 - required - confidential address category - this is a string of
                         one or more numerics, e.g. - 134, where category
                         numbers are:
  

• DSSOFLG
  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 
       Zip Code (internal)^Zip Code (external)
       multiple IEN value^County Name.
  data elements.  The default value is 0.  Any state, county, or zip code 
  data element's return value will be affected by this flag.
    If DSSOFLG=0, return:
       State Abbreviation
       a 5- or 9-digit Zip Code 
       County Name.
    If DSSOFLG=1, return:
       IEN to file 5^State Name^State Abbreviation
  

On error return -1^error message
     6       Date of Death(internal);Date of Death(external)
     7       Race
     8       Religion
     9       Marital Status
    10       Employment Status
    11       1st Street Address Line
    12       2nd Street Address Line
    13       3rd Street Address Line
    14       City
    15       State Abbreviation [or IEN^State Name^State Abbreviation]
Else return:
    16       Zip (9 or 5) [or Zip(internal)^Zip(external)]
    17       County [or multiple IEN^County Name]
    18       Home Phone
    19       Work Phone
    20       LastName^FirstName^Middle^Suffix/Title
 ---- DSSODAT(21 - DSSODAT(28) all refer to confidential address  ----
    21       Confidential Address category bitmap.  Default value of 
             "00000".  This is a 5-character string of 0s and 1s where 
             each bit refers to whether or not the particular category
             is active or not as of the date in the DSICONF parameter.
 DSSODAT()  Description
             Only those categories requested in DSICONF parameter will
             have a bit value of 1:
    22       Street Address 1
    23       Street Address 2
    24       Street Address 3
    25       City
    26       State Abbreviation [or IEN^State Name^State Abbreviation]
    27       Zip (9 or 5) [or Zip(internal)^Zip(external)]
    28       County [or multiple IEN^County Name]
    
 ----------  --------------------------------------------
***********************************************************************
    29       Primary Eligibility^other elig^other elig^...
    30       Eligibility Status - If the Service Connected? field is YES,
             a "1" will be returned in the first piece; otherwise, 
             a "0" will be returned.  If service connected, the SERVICE
             CONNECTED PERCENTAGE field will be returned in the second
             piece.
    31       Equals "1" if the patient is a Veteran; otherwise, set to 
             "0".
    32       Claim Number 
     1       Patient Name
    33       Current Means Test Status Code^Name
     2       SSN;Dashed SSN
     3       DOB(internal);DOB(external)
     4       Age
     5       Sex