SDEC PREFGET

TITLEVALUE
NAMESDEC PREFGET
DESCRIPTIONGet values from SDEC PREFERENCES AND SPECIAL NEEDS file for a given
patient.
TAGPREFGET
ROUTINESDEC
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERDFN
DESCRIPTION(integer) Patient ID - Pointer to the PATIENT file 2 (lookup by name is
not accurate if duplicates)
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERINAC
DESCRIPTIONInactive entries have been deprecated and does not have an
effect. however the parameter can be passed, but ignored.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONSuccessful Return:
Global array containing a list of preferences in which each array
entry contains preference data separated by ^:

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
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).
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:
A single entry in the Global Array in the format "-1^"
"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.
AVAILABILITYRESTRICTED
INACTIVEACTIVE
CLIENT MANAGER
WORD WRAP ONFALSE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED