Kernel V. 8.0 APIs Banner [skip navigation]
VHA Office of Information - Health Systems Design and Development (HSD&D) Banner

DELETE^XQALERT(): Clear Obsolete Alerts

Reference Type: Supported, Category: Alerts, Integration Agreement: 10081

Description

This API deletes (clears) a single alert, for the current user (XQAKILL=1) or all recipients (XQAKILL=0 or XQAKILL undefined). The current user (as identified by the value of DUZ) does not need to be a recipient of an alert; however, in that case, only a value of zero (0 or undefined) for XQAKILL makes sense.

DELETE^XQALERT, unlike DELETEA^XQALERT, deletes only a single alert whose alert identifier matches the complete Alert Identifier.

NOTE: For more information on alert identifiers, please refer to the "Package Identifier versus Alert Identifier" topic in the Kernel Programmer Manual.

Format

  DELETE^XQALERT(xqaid[,xqakill])

Input Parameters

xqaid:

(required) Alert Identifier of the alert to delete. It must be a complete Alert Identifier, containing all three semicolon pieces. The first semicolon piece (Package Identifier) must be in the same form as the alert creator defined it, the second piece being the DUZ of the user who created the alert, and the third piece being the time the alert was created (the second and third pieces are defined by the Alert Handler).

xqakill:

If XQAKILL is undefined or zero (0), the Alert Handler deletes the alert for all recipients. If XQAKILL is set to 1, Alert Handler only purges the alert for the current user as identified by DUZ (using a value of 1 only makes sense if the current user is a recipient of the alert, however).

If the software application identifier portion of the alert identifier is "NO-ID", however, the alert is treated as if XQAKILL were set to 1, regardless of how it is actually set.

Output

none

 

 


VA (Internet) / VA (Intranet) / OI / HSD&D / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: November 15, 2006

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.