SDEC PREFGET (3567)    REMOTE PROCEDURE (8994)

Name Value
NAME SDEC PREFGET
TAG PREFGET
ROUTINE SDEC
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY RESTRICTED
INACTIVE ACTIVE
WORD WRAP ON FALSE
DESCRIPTION
Get values from SDEC PREFERENCES AND SPECIAL NEEDS file for a given 
patient.
INPUT PARAMETER
  • 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)
    
  • INAC
    PARAMETER TYPE:   LITERAL
    REQUIRED:   NO
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    1=include inactive entries
    
RETURN PARAMETER DESCRIPTION
 ; Successful Return:
file - defaults to Current User
 ;          5. (text)           Added by User Name
 ;          6. (date/time)      Date/Time Inactivated in external format
 ;          7. (integer)        Inactivated by user - Pointer to NEW 
PERSON file
 ;          8. (text)           Inactivated by user Name
 ;          9. (text)      Remarks are returned as a single string of 
text that may be delimited by carrage return/line feed $c(13,10).
 ;             1         2               3                4
 ;      
 ;  Global array containing a list of preferences in which each array 
"T00020DFN^T00030PREF_TEXT^T00020DATE_ADDED^T00030ADDED_BY_USER_IEN"
 ;              5                        6                      7
 ;       
^T00030ADDED_BY_USER_NAME^T00020DATE_INACTIVATED^T00030INACTIVATED_BY_USER
_IEN"
 ;              8                              9
 ;       ^T00030INACTIVATED_BY_USER_NAME^T00100REMARKS"_$C(30)
 ; Caught Exception Return:
 ;   A single entry in the Global Array in the format "-1^<error text>"
 ;   "T00020RETURNCODE^T00100TEXT"
entry contains preference data separated by ^:
 ; 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 
format - defaults to NOW
 ;          4. (integer)        Added by User - Pointer to NEW PERSON