Error Processing in the Financial Modules

Levels of Severity

Some of the financial modules (Accounts Payable, Accounts Receivable, and General Ledger) use two levels of error severity:

Critical

A critical error must be corrected by the user before processing can continue.  The application program displays an error message on the screen.  After the user corrects the situation, the application program continues processing.  A typical critical error is an invalid field on a data entry screen.

Abort

An abort is a serious problem that causes the program to end.  A system error message is displayed on the screen, and a more detailed message is written to the message queue (FPMSGQ).

Error Messages

Financial error messages are stored on the Error Message File (FPMSGF).  When an error occurs, the appropriate message is retrieved from this file.  Each record on the file has two fields:

Error code

Identifies the error.  This field is 7 characters long.

Error message

Text that is printed on the screen or report.  This field is 140 characters long.

Second-level error message

This text is displayed if the user requests Help for the error message.  This field is 1187 characters long.

Error Processing Routines

When an error occurs, the financial application programs call FPERRC, a CL program that retrieves the appropriate error message from the Error Message File (FPMSGF).  The error messages are placed in the message queue (FPMSGQ).  You can display the messages through the Display Financial Messages option on the AR, AP, or GL menu.  The following common subroutines are used in the financial modules:

SETERR

Moves error flags from the error data structures into the corresponding screen indicators.

*PSSR

Called for abort errors.  It loads the message to be returned to the menu program from the message file.  It then calls FPIORR to log the message on the message queue.

FPIOERR

Called whenever a program logic, exception, or file I/O error is detected.  It places the error message in the message queue (FPMSGQ).