DSIV EXCEPTION REPORT (2556)    REMOTE PROCEDURE (8994)

Retrieves ICB Exception data from 19625.1.  A nightly job queued from 
option DSIV NIGHTLY REPORT processes the report - this rpc now just 
returns the data.

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

  Contains the start date for the report.  This is the report date in file 
  19625.1.  Since reports are run each night, it is the same as the 
  appointment date.
  

• EDT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  Contains the end date for the report.  Defaults to current date if not 
  sent.
  

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

  Contains a flag to denote recursive calls to get the Exception Report 
  data.  MORE=0 is the starting condition (start at the start date in 
  parameter 1), MORE=1 is to continue getting the records until the value 
  ~END~ is received.  The number of records returned for each call is based 
  on the DSIV MAX NUM ENTRIES parameter.  The MORE parameter and recursive 
  calling to the rpc prevents network timeouts when a lot of data is being 
  returned (e.g. one month of Exception data).
  

• LOCS
  PARAMETER TYPE:   LIST
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  Contains an array of clinics to include or exclude from the report.  The 
  array is in the format:
   LOCS(1)="INCLUDE"   (or "EXCLUDE" to exclude the clinics)
   LOCS(n)=228  (clinic IEN from file 44)
  

Returns the following global array data:
 Ret(n)=clinic^appt dt/tm^patient^check-in user^check-out user^FM appt dt
 ~END~ is sent to denote the end of the report.  
 -1^error denotes error.
 The FM (Fileman) appt date at the end helps the GUI re-sort the data.