USER ALERTS    ICR (4834)

Upon return this variable holds the global reference
of the resulting alert data. The output consists of the following:

ROOT=TOTAL COUNT

ROOT(1)=KEY  MSG TXT^ALERT ID

If Alert Forwarded:  ROOT(+1)=KEY  -----Forwarded by: PROVIDER NAME
Generated: DATE/TIME FORWARDED^ALERT ID

If Alert Forwarded contains comment text:  ROOT(+1)=KEY  -----FORWARD
COMMENT^ALERT ID

ROOT(+1)=KEY  MSG TXT^ALERT ID

ROOT(+1)...

KEY = Value is determined in order of occurance as listed below.

G = GUID FOR GUI
L = LONG INFO TEXT
I = INFORMATION ONLY
R = (Everything Else)

MESSAGE TEXT = The text of the message to be presented to the user at the time
when he cycles through the menu system the first time after the alert has been
filed for the user, and when the user selects the VIEW ALERTS option.

ALERT ID = This id may simply be a package namespace, or it may be a namespace
followed by additional data to more accurately identify the type or purpose of
the alert.

PROVIDER NAME = This is the name of the provider who forwarded the alert.

DATE/TIME FORWARDED = This is the date/time that the forward alert action
occurred.


Example Output:
---------------
ROOT=3

ROOT(1)="R  PATIENTLNAME,PATIENTFNAME (P6666): [LOCATION] Order placed:
ACETAMINOPHEN TAB  MM/YY HH:MM^ALERT ID"

ROOT(2)="R  -----Forwarded by: PROVIDERLNAME,PROVIDERFNAME   Generated:
MM/DD/YY HH:MM:SS^ALERT ID"

ROOT(3)="R  -----TESTING ALERT FORWARD ACTION^ALERT ID"

The DUZ of the user for whom to retrieve the alerts.

This variable is not used.

This variable is not used.

Add FLAG to filter deferred alerts.

Upon return this variable holds the global reference
of the resulting alert data. The output consists of the following:

ROOT=TOTAL COUNT

ROOT(1)="KEY  DISPLAY TEXT^NAME"

ROOT(1,"PROCESSED")="ALERT FIRST DISPLAYED^FIRST SELECTED ALERT^ PROCESSED
ALERT^DELETED ON^RECIPIENT TYPE^PROCESS BY^SURROGATE FOR^ FORWARDED BY OR FOR
FORWARDED DATE/TIME"

ROOT(2)=KEY  DISPLAY TEXT^NAME

ROOT(2,"PROCESSED")...

KEY = Value is determined in order of occurance as listed below.

G = GUID FOR GUI
L = LONG INFO TEXT
I = INFORMATION ONLY
R = (Everything Else)

DISPLAY TEXT = The information that will be displayed on an alert.

NAME = This id may simply be a package namespace, or it may be a namespace
followed by additional data to more accurately identify the type or purpose of
the alert.

PROVIDER NAME = This is the name of the provider who forwarded the alert.

DATE/TIME FORWARDED = This is the date/time that the forward alert action
occurred.


Example Output:
---------------
ROOT=1

ROOT(1)="R  PATIENTLNAME,PATIENTFNAME (P6666): [LOCATION] Order placed:
ACETAMINOPHEN TAB  MM/YY HH:MM^NAME (ie ALERT ID)"

ROOT(1,"PROCESSED")="YYYMMDD.HHMMSS^YYYMMDD.HHMMSS^
YYYMMDD.HHMMSS^YYYMMDD.HHMMSS^INITIAL RECIPIENT^ CPRSPROVIDER,SEVENTEEN^^"

The DUZ of the user for whom to retrieve the
processed alerts.

The start date in which to begin retrieving alerts.

The end date in which to stop retrieving alerts.

The maximum number of alerts to retrieve.

This variable is not used.

This variable contains the name of the local array
used to store the alerts returned.

Example usage: D GETPAT2("ROOT",PATIENT,PAGE,LIMIT)

Returns: ROOT=Total number of alerts in the page.  ROOT(0)=Page^Total number
of pages ROOT(1)="   CPRSPATIENT,EIGH (C0008): Lapsed Unsigned
Order(s)^OR,100022,78;10000000200; 3221009.105002^14534305" ROOT(2)="
CPRSPATIENT,EIGH (C0008): Order requires electronic signature.^OR,100022,12;
10000000200;3221008.052"

DFN of the patient for which to retrieve alerts.

The 'page' of the alerts to retrieve, assuming there
is more than one page available. For example, if the limit is to retrieve 25
alerts at one time, and the patient has 75 alerts, there would be three pages.

The limit of the number of alerts to retrieve per
page.

This variable contains an error message if the
attempt to defer the alert fails.

The user responsible for the alert.

The date/time the alert is deferred til...user
responsible sets the date...maximum of 14 days from the date/time deferred.

The IEN of the alert in file 8992 2nd piece of the
alert date/time multiple. DG,IEN of file;original recipient;date/time of
alert.

ROOT(0)=The count of entries following in the ROOT
array.  ROOT(#)=Alert details.

DFN of the patient for which to retrieve alerts.

From Date.

To Date.