| RETURN PARAMETER DESCRIPTION | 
Successful Return:
                      format - defaults to NOW
   4. (integer)       Added by User - Pointer to NEW PERSON 
                      file - defaults to Current User
   5. (text)          Added by User Name
   6. deprecated      No longer used
   7. deprecated      No longer used
   8. deprecated      No longer used
   9. (text)          Remarks are returned as a single string of 
                      text that may be delimited by carriage return/line
                      feed $c(13,10).
 Global array containing a list of preferences in which each array 
       1         2               3                4        
  "T00020DFN^T00030PREF_TEXT^T00020DATE_ADDED^T00030ADDED_BY_USER_IEN^"
       5                        6                      7       
  "T00030ADDED_BY_USER_NAME^T00020DATE_INACTIVATED^"
             7                         8        
  "T00030INACTIVATED_BY_USER_IEN^T00030INACTIVATED_BY_USER_NAME^"
        9
  "T00100REMARKS"_$C(30)
  
  Caught Exception Return:
 entry contains preference data separated by ^:
        A single entry in the Global Array in the format "-1^<error text>"
    "T00020RETURNCODE^T00100TEXT"
  Unexpected Exception Return:
   Handled by the RPC Broker.
   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.
 
 The ^ pieces are as follows:
 
   1. (integer)       Patient ID - pointer to PATIENT file
   2. (text)          Preference text
   3. (date/time)     Date/Time preference added in external 
 |