DSSO FILL SUSPENSE GRID

TITLEVALUE
NAMEDSSO FILL SUSPENSE GRID
DESCRIPTIONThis RPC is used to populate the suspense grid in the GUI.

When using this RPC for the APAT Dashboard, leave Sort="" and provide the
starting date from which to retrieve all suspense items for all
statuses. This will be more efficient than retrieving each status
individually.

When a user selects a station, all consults affiliated with that station
(even CBOCs) will be returned, but when a user selects a CBOC, only
consults affiliated with that CBOC will be returned.
TAGEN
ROUTINEDSSOSUS
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERDSSOUSER
DESCRIPTIONThis is the DUZ of the user.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERDSSOSITE
DESCRIPTIONA Prosthetic Site IEN (#669.9)

The value "ALL" can be passed to search all Prosthetic Sites.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH30
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERDSSOSORT
DESCRIPTIONA flag which determines what results are returned:
P = Pending
O = Open

Only one value may be passed in.
Only used for Open and Pending requests.
Closed and Cancelled requests are only returned with all suspense items
for a patient.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH1
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERDSSOIEN
DESCRIPTIONLast 668 IEN read
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH15
INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERDSSODFN
DESCRIPTIONPatient file (#2) IEN - required for Closed and Cancelled suspense item
requests; all suspense items for the patient are returned.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH15
INPUT PARAMETERSSEQUENCE NUMBER6
INPUT PARAMETERDSSODTE
DESCRIPTIONStarting date of returned suspense items or Last Suspense Date Processed;
if Last Suspense Date Processed, must be in date.time format
(yyymmdd.hhmmss).

When used, all suspense items of any status (Open, Pending, Closed, and
Cancelled) that were created on or after the requested date will be
returned.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH14
INPUT PARAMETERSSEQUENCE NUMBER7
INPUT PARAMETERDSSOCAL
DESCRIPTIONThis is a flag to indicate if days should be calculated as work days or
calendar days. Defaults to work days.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH1
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONReturns an array List[n].

The first line of the returned array will be in the following format:
List [0] = Purge Date ^ Create Date ^ descriptive information
Example: 3150123^3150123^DSS APAT Suspense Grid temp"

The format of the returned array will be as follows:
List[n] = p1^p2^p3^p4^p5^p6^p7^p8^p8^p10^p11^p12^p13^p14^p15^p16

p1 = Suspense Date
p2 = Patient Name
p3 = Patient SSN
p4 = Type of Request
p5 = Description of Item/Service
p6 = Initial Action Date
p7 = # Days from Create
p8 = Status
p9 = File #668 IEN
p10 = Station
p11 = Patient IEN
p12 = Work Order IEN (#664.1)
p13 = Work Order #
p14 = Assigned Tech DUZ
p15 = Consult file (#123) IEN
p16 = Prosthetic Patient (1=Yes, 0=No)
p17 - Consult file (#123) Urgency (#5)

The Last Record Processed will appear as:
List[9999999999999998] = ^-pc 1 Text "$$LAST RCD$$"
^-pc 2 IEN of last record processed
^-pc 3 yyymmdd.hhmmss of last
record processed

The End of the dataset will appear as:
List [999999999999999] = Text "$$END$$"

If an error occurs, the return will be:
List["E"] = Date^Date.Time^^Error in Suspense Grid:-1^xxxxxxxx
where xxxxxxxx=text of error message
Example:
3150124^3150122.235334^Error in Suspense Grid:-1^SITE not provided
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED