Error Processing in the Manufacturing and Distribution Modules

Levels of Severity

MAC-PAC has four levels of error severity:

Information

Information messages are handled completely within the application program.  The program displays a message on the screen.  No further action is required. 

Warning

Warning error codes begin with the letters MPW.  Warning errors may require the user to take action.  The application program displays a warning message on the screen (for online programs) or on the transaction register (for batch programs).  After the message is displayed, the application program continues processing.

Critical

Critical error codes begin with the letters MPC.  A critical error must be corrected by the user before processing can continue.  The application program displays an error message on the screen (for online transactions) or on the transaction register (for batch programs).  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

Abort error codes begin with the letters ABT.  An abort is a serious problem that causes the program to end.  An error message is sent to the system operator and the following message is displayed on the screen:

MAC-PAC SYSTEM ERROR HAS OCCURRED

This message is printed on the transaction register for batch programs.  In addition, a CT010X report is generated and placed in the user's default output queue.  This report lists the detailed ABT error message that caused the application program to abend.

Error Messages

Error messages within MAC-PAC are stored on the Error Message File (CT120M).  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.  The first 3 characters are MPW (warning), MPC (critical) or ABT (abort).  The remaining 4 characters are an error number that uniquely identifies the error.

Error message

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

CT010X Report

A CT010X report is generated every time a MAC-PAC program abends.  This report identifies why the error occurred.  The CT010X report has several versions depending on why the abend occurred.  To differentiate the reports, each version has a different suffix.  For example, if the program ended because of a file exception a CT010FIL report would be generated.  The figure below shows all the CT010X reports and their suffixes.

CT050 Report

A CT050 report is produced every time an off-line program abends because it was passed an invalid parameter.  The report contains the program number, error code, and a message identifying the critical error caused by the parameter.  No corresponding error message is sent to the system operator.

Abort Processing Routines

Abort errors are handled through the *PSSR common subroutine.  This subroutine is copied into all programs.  It calls several other common subroutines:

·     ZERRCH.  Retrieves appropriate error message and displays it.

·     ZIOERR.  Handles input/output from the Error Message File (CT120M).

·     ZSYSER.  Sends "MAC-PAC SYSTEM ERROR" message to system operator and writes CT010X report.

·     MPERR.  Sends "MAC-PAC SYSTEM ERROR" message to system operator and writes CT010X report.

·     ZSYSOP.  Sends "System Data Missing" message to system operator if the error was the result of a failed I/O operation.

CT010FIL                                                                                          PAGE  :    1

                                  MAC-PAC ERROR/EXCEPTION REPORT                                             DATE  :  2/27/92

                                                                                                             TIME  : 11:32:02

                                      FILE EXCEPTION REPORT

                   FILE EXCEPTION FOUND IN PROGRAM:                  LINE

                                                      OP690E              261900

                   JOB NAME             :             OPBILLLDG

                   USER NAME            :             V70SECOFR

                   JOB NUMBER           :             030141

         GENERAL INFORMATION

                   THE FILE IN ERROR IS           :   OP120AL3

                   ITS STATUS IS                  :   00012

                   LAST OPERATION PERFORMED       :   LIO

                   LAST RECORD ACCESSED           :

         MESSAGE DESCRIPTION

                   FILE EXCEPTION OCCURRED IN LINE   261900  WITH MESSAGE CPF5006

                   PROGRAM STATUS WAS   00000

                                       NO EXCEPTION/ERROR OCCURRED

                                       ** END OF REPORT **

CT010X Report.