DSSO FILL SUSPENSE GRID (4326)    REMOTE PROCEDURE (8994)

This RPC is used to populate the suspense grid in the GUI.
consults affiliated with that CBOC will be returned.
 
When using this RPC for the APAT Dashboard, leave Sort="" and provide the 
starting date from which to retrieve all suspense items for all 
statuses.  This will be more efficient than retrieving each status 
individually.
 
When a user selects a station, all consults affiliated with that station 
(even CBOCs) will be returned, but when a user selects a CBOC, only

• DSSOUSER
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This is the DUZ of the user.
  

• DSSODFN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   15
  REQUIRED:   NO
  SEQUENCE NUMBER:   5
  DESCRIPTION:   

  Patient file (#2) IEN - required for Closed and Cancelled suspense item 
  requests;  all suspense items for the patient are returned.
  

• DSSODTE
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   14
  REQUIRED:   NO
  SEQUENCE NUMBER:   6
  DESCRIPTION:   

  Starting date of returned suspense items or Last Suspense Date Processed;
  if Last Suspense Date Processed, must be in date.time format
  (yyymmdd.hhmmss).
   
  When used, all suspense items of any status (Open, Pending, Closed, and 
  Cancelled) that were created on or after the requested date will be 
  returned.
  

• DSSOCAL
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   7
  DESCRIPTION:   

  This is a flag to indicate if days should be calculated as work days or 
  calendar days.  Defaults to work days.
  

• DSSOSITE
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  A Prosthetic Site IEN (#669.9)
   
  The value "ALL" can be passed to search all Prosthetic Sites.
  

• DSSOSORT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  A flag which determines what results are returned:
    P = Pending
    O = Open
   
  Only one value may be passed in.
  Only used for Open and Pending requests.
  Closed and Cancelled requests are only returned with all suspense items
  for a patient.
  

• DSSOIEN
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   15
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  Last 668 IEN read
  

Returns an array List[n].
 
    p1  = Suspense Date
    p2  = Patient Name 
    p3  = Patient SSN
    p4  = Type of Request
    p5  = Description of Item/Service
    p6  = Initial Action Date
    p7  = # Days from Create
    p8  = Status
    p9  = File #668 IEN
 
    p10 = Station
    p11 = Patient IEN
    p12 = Work Order IEN (#664.1)
    p13 = Work Order #
    p14 = Assigned Tech DUZ
    p15 = Consult file (#123) IEN
    p16 = Prosthetic Patient (1=Yes, 0=No)
    p17 = Consult file (#123) Urgency (#5)
    p18 = Patient Date of Death
    p19 = Patient Date of Birth
The first line of the returned array will be in the following format:
 
The Last Record Processed will appear as:  
        List[9999999999999998] = ^-pc 1 Text "$$LAST RCD$$"
                                 ^-pc 2 IEN of last record processed
                                 ^-pc 3 yyymmdd.hhmmss of last 
                                          record processed
 
The End of the dataset will appear as:
        List [999999999999999] = Text "$$END$$"
 
List [0] = Purge Date ^ Create Date ^ descriptive information
If an error occurs, the return will be:
 List["E"] = Date^Date.Time^^Error in Suspense Grid:-1^xxxxxxxx
   where xxxxxxxx=text of error message
Example: 
 3150124^3150122.235334^Error in Suspense Grid:-1^SITE not provided
  Example:  3150123^3150123^DSS APAT Suspense Grid temp"
 
The format of the returned array will be as follows:
  List[n] = p1^p2^p3^p4^p5^p6^p7^p8^p8^p10^p11^p12^p13
            ^p14^p15^p16^p17^p18^p19