This standard runtime function displays the error message, if any, that you have defined for a field/control. It complements the ACCEPT FIELD, EXECUTE EVENT, VALIDATE ALL FIELDS, and VALIDATE FIELD standard runtime functions by allowing the application program to display the error message under circumstances that prevent RM/Panels from displaying it automatically.
SHOW FIELD ERROR displays the message, waits for the user to press any key, erases the message, and then returns control to the application program.
The application program must set the name of the field/control for which the error message is to be displayed in RMP--FIELD-NAME. No occurrence number is required, even for fields/controls with multiple occurrences, as the error message applies to each occurrence.
| Status value | Description |
|---|---|
| 0 | The function executed successfully. |
| 1 | The field/control name is invalid. |
| 5 | The panel is not in this library |
| 6 | The library does not exist. |
| 14 | A COBOL input/output error was encountered on the panel library during execution of this function. To determine the exact nature of the I/O error, use the C$RERR subprogram. |