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

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

Reference Type: Supported, Category: Alerts, ICR#: 2788

Description

The $$PKGPEND^XQALBUTL 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 (#200) file 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 the xqauser input parameter 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.

Examples

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