Appendix B: Additional Error Handling

To enhance the core error processing, Natural Business Services supplies the SPSERRN2 user exit. This user exit allows you to add special error processing, such as sending notification of errors to the operator.

Start of instruction setTo create and activate custom error processing

  1. Edit the user exit in the SYSBIZ library.

  2. Copy the object code for the modified user exit to the SYSLIBS library.

Notes:

  1. For backwards compatibility, the SPSERRN user exit is also supplied. Use SPSERRN2 for all new development.
  2. If you are using the Natural Development Server (NDV), avoid using screen input/output parameters.
  3. Do not stop or terminate processing in the subprograms or associated modules. To ensure complete tracking of internal business service information, control should return to the Natural Business Services error handler.
  4. If you add custom error processing in either user exit, back up the program before upgrading Natural Business Services in the future. You can move the program back after installation is complete.

SPSERRN2 User Exit

The SPSERRN2 user exit uses the CDERRLD2 parameter data area, which contains the following parameters:

  • MSG_TYPE

  • ERROR_TYPE

  • MSG_CATEGORY

  • ERROR_CLASS

  • ERROR_LIBRARY

  • ERROR_PROGRAM

  • ERROR_NUMBER

  • ERROR_LINE

  • ERROR_LEVEL_NBR

  • ERROR_MSG

  • NBS_SERVICE

  • NBS_DOMAIN

  • NBS_METHOD

  • PROCESS_DESCRIPTION

  • ERROR_DATE

  • ERROR_TIME

  • ERROR_TIMESTAMP

SPSERRN User Exit

The SPSERRN user exit is supplied for backwards compatibility. You should use the SPSERRN2 user exit for all new development.

SPSERRN uses the CDERRLDA parameter data area, which contains the following parameters:

  • ERROR-NR

  • ERROR-LINE-NR

  • ERROR-STATUS

  • ERROR-PROGRAM

  • ERROR-PROGRAM-LEVEL