Previous Topic: $PAD FunctionNext Topic: $PANELFIELDERROR Function


$PANELERROR Function

$PANEL‑ERROR is a Boolean function that evaluates to True when an input error is detected in an input field of a panel. As long as one field contains erroneous data, $PANEL‑ERROR is True. If more than one field is detected with erroneous data, $PANEL‑ERROR remains true until the user corrects all the fields in the panel or until the application modifies all of the erroneous fields. You can modify fields with the following statements: MOVE, SET, RESET, REFRESH, or RELEASE.

$PANEL‑ERROR is only meaningful when the panel parameter Edit‑rule error procedure is set to A (application). If this parameter is set to C (Clarify), the CLARIFY function prevents detectable errors before returning control to the application. See the Creating Panel Definitions Guide for more information.

This function has the following format:

$PANEL‑ERROR[(panel‑name)]
panel‑name

Specifies the panel containing the fields to test for erroneous data. When you omit a panel name, the function applies to the last panel transmitted.

Example

In this example, the panel is retransmitted until all the errors detected in the input panel fields are corrected.

LOOP    
TRANSMIT PANEL‑A REINPUT
    WHILE $PANEL‑ERROR
ENDLOOP