SDEC PREFSET (3569)    REMOTE PROCEDURE (8994)

Set values to SDEC PREFERENCES AND SPECIAL NEEDS file.

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

  (integer) Patient ID - Pointer to the PATIENT file 2  (lookup by name is 
  not accurate if duplicates)
  

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

    PREF = List of preference data separated by ^
                              SPECIAL MODE OF TRANSPORTATION
           2. (date/time)   Date/Time preference added in external
                                    format, defaults to NOW
           3. (integer)     Added by User - Pointer to NEW PERSON file,
                                    defaults to Current User
           4. deprecated - do not use, leave blank.
           5. deprecated - do not use, leave blank.
           6. (free text)   Remarks single string of text will be
                            converted to word processor format.
                            @ deletes previous Remark
           Each ^ piece contains the following Pipe pieces |:
           1. (text)      Preference text; precede text with @ to delete
                          Valid values are:
                              GENDER SPECIFIC PROVIDER
                              HEARING IMPAIRED
                              LANGUAGE PREFERENCE
                              NEEDS ESCORT
                              ON STRETCHER
  

Successful Return:
     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.
 ;     text back to the client.
   A single entry in the Global Array in the format:
    "0^<optional msg text>"
    "T00020RETURNCODE^T00100TEXT"
 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.