Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$PKGPEND^XQALBUTL(): Pending Alerts for a User in Specified Software

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

Description

This extrinsic function returns whether or not the user specified has an alert with XQAID containing the first ";"-piece (software/package identifier) indicated by the xqapkg input parameter pending. It returns either of the following:

Format

  $$PKGPEND^XQALBUTL(xqauser,xqapkg)

Input Parameters

xqauser:

(required) This is the Internal Entry Number (IEN, DUZ value) in the NEW PERSON file (#200) for the desired user.

xqapkg:

(required) This is the software/package identifier portion of the alert identifier (XQAID). It is a textual identifier for the software that created the alert and is the first ";"-piece of XQAID. It can be used in this context to determine whether or not the user specified by xqauser has any alerts pending containing the specified software identifier. The software identifier used can be a complete software identifier (e.g., XU-TSK) or more general (e.g., XU) to find users with any XU software alerts.

Output

returns:

Returns:

  • 1—YES, indicates one or more alerts pending for the specified user containing the software/package identifier string in the package part of XQAID.

  • 0—NO, alerts not pending.

Example 1

The following is an example of an alert not pending:

>S XQAPKG="XU"

>W $$PKGPEND^XQALBUTL(20,XQAPKG)
0

Example 2

The following is an example of an alert pending (one or more):

>S XQAPKG="XU"

>W $$PKGPEND^XQALBUTL(20,XQAPKG)
1

 


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

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.