SDEC FAPPTGET (3570)    REMOTE PROCEDURE (8994)

Get Future appointments for a given patient and date range from the 
APPOINTMENT multiple of the PATIENT file 2.

• DFN
  PARAMETER TYPE:   LITERAL
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  Patient ID - Pointer to the PATIENT file 2.
  

• SDBEG
  PARAMETER TYPE:   LITERAL
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  Begin of date range to search for appointments in external format.
  

• SDEND
  PARAMETER TYPE:   LITERAL
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  End of date range to serch for appointments in external format.
  

• SDANC
  PARAMETER TYPE:   LITERAL
  REQUIRED:   NO
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  ancillary flag  0=all appointments; 1=only ancillary appointments
  

Successful Return:
    4. Appointment Date in external format
    5. Status text
    6. Ancillary Text
    7. APPT REQUEST TYPE Field (#22) from the
       SDEC APPOINTMENT File (#409.84)
    8. Appointment request IEN
    9. Appointment type IEN
    10. Appointment type Name
    11. Cancel/noshow date 
    12. Pre-registration Date
  Global Array in which each array entry contains Appointment Data from 
 
"T00020DFN^T00020CLINIC_IEN^T00030CLINIC_NAME^T00020APPT_DATE^T00020STATUS
^T00100ANCTXT^^T00030PRECKNCOMPLETE^T00030TIMEZONE"
^T00030CANDATE"
 
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.
the
    M errors are trapped by the use of M and Kernel error handling.
    The RPC execution stops and the RPC Broker sends the error generated
    text back to the client.
  PATIENT file
  
  Data is separated by ^:
    1. DFN
    2. Clinic IEN
    3. Clinic Name