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

APPERROR^%ZTER: Set Application Error Name in Kernel Error Trap Log

Reference Type: Supported, Category: Error Processing, ICR#: 1621

Description

The APPERROR^%ZTER API sets the "application error" text passed in as the error name in the Kernel error trap log (i.e., ERROR LOG [#3.075] file).

NOTE: The APPERROR^%ZTER API replaces the need to set $ZE before calling ^%ZTER:

Before:

    >S $ZE=”application error” D ^%ZTER

After:

    >D APPERROR^%ZTER(“application error”)

NOTE: This API was released with Kernel Patch XU*8.0*431.

Format

  APPERROR^%ZTER("application error")

Input Parameters

application error:

This input parameter is the "application error" name that gets displayed in the Kernel error trap log (i.e., ERROR LOG [#3.075] file).

Output

returns:

Displays the "application error" text passed in as the error name in the Kernel error trap log (i.e., ERROR LOG [#3.075] file).

Example

    >DO APPERROR^%ZTER("My Application Error")

Check the Kernel error trap and see if there is an error called "My Application Error".