Print Page as PDF
DBIA2864 ICR (2864)

DBIA2864    ICR (2864)

Name Value
NUMBER 2864
IA # 2864
DATE CREATED 1999/07/12
CUSTODIAL PACKAGE TEXT INTEGRATION UTILITIES
CUSTODIAL ISC Salt Lake City
USAGE Controlled Subscription
TYPE Routine
DBIC APPROVAL STATUS APPROVED
ROUTINE TIUPP3
NAME DBIA2864
GENERAL DESCRIPTION
This call evaluates whether the specified patient has
any postings (i.e., (C)risis Notes, Clinical (W)arnings, (A)llergies, or
Advanced (D)irectives on file, and returns a list of such documents, including
the dates and times on which addenda may have been entered for them.

Note that the existence of an Advance Directive posting does NOT necessarily
indicate that the patient has an Advance Directive. That an Advance Directive
exists can only be determined by reading the text of the 'D' postings, which
may (or may not) indicate that a Directive exists,
STATUS Active
KEYWORDS
  • POSTINGS
  • COVERSHEET
DURATION Till Otherwise Agreed
ID TIUPP3
COMPONENT/ENTRY POINT
COMPONENT/ENTRY POINT COMPONENT DESCRIPTION VARIABLES
ENCOVER(DFN)
This procedure receives the parameter DFN (pointer to
PATIENT FILE (#2)), and returns the local variable MSG along with the
^TMP("TIUPPCV",$J) array.

The MSG variable is returned as follows:

Patient has postings on file:
MSG=0^Patient Postings on file

Patient DOES NOT have postings on file:
MSG=-1^No Patient Postings on file

while the ^TMP("TIUPPCV",$J) array looks like this:

Patient has postings on file:

^TMP("TIUPPCV",$J,n)=IEN^INDICATOR^PRINT NAME^SUBJECT^DATE/TIME^ADDENDUM

where IEN = Internal Entry of the posting in the TIU DOCUMENT FILE (#8925)
INDICATOR = C for CRISIS NOTE
W for CLINICAL WARNING
A for ALLERGY/ADR NOTE
D for ADVANCED DIRECTIVE
PRINT NAME = the PRINT NAME (#.03) field in file 8925
SUBJECT = the optional Free text subject of the note.
DATE/TIME = the Date/time of the note
ADDENDUM = indicator of last addendum w/date and time.

Patient DOES NOT have postings on file:

^TMP("TIUPPCV",$J) is UNDEFINED.

^TMP("TIUPPCV",$J) may be killed before and after use.
VARIABLES TYPE VARIABLES DESCRIPTION
DFN Input
This is the pointer to the PATIENT FILE (#2).
SUBSCRIBING PACKAGE
SUBSCRIBING PACKAGE ISC SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING Salt Lake City
CLINICAL PROCEDURES
Clinical Procedures is using this API to indicate that
a directive may exist.  They are using it with the understanding that users
need to review the note title and text before concluding that a directive in
fact exists.
IMAGING
VA POINT OF SERVICE (KIOSKS)
VIRTUAL PATIENT RECORD
Added 11/19/18 for VPR*1.0*8.