Rational Programming Patterns for System z

The online error message file

The online error message file contains records whose description is detailed here.

This file has the following physical characteristics:
Its records are constituted of the following elements:
Table 1. Description of a record
Number Position Meaning
1 3 Library code
2 1 Entity type:
  • A: For Data Structures or Segments (Batch error messages).
  • H: For Screens (online error messages).
  • I: Record reserved for internal use by the online function. It is used by the help function to indicate the position of a field on a Screen, using a line / column formula.
3 6 Instance code
4 4 Error number:
  • Automatic error message or explicit error message on a Data Element:

    The first three positions identify the rank of the erroneous Data Element, according to the order in the -CE Lines tab.

    • 1 - 3: Rank of the erroneous Data Element, according to the order in the -CE Lines.
    • 4: Error type
      • 2: invalid absence
      • 4: erroneous class
      • 5: erroneous value
      • 6, 7 ...: additional errors
  • Help message associated with an automatic error message or a manual error message on the Data Element:
    • 1 - 3: Rank of the the erroneous Data Element, according to the order in the -CE Lines.
    • 4: Location of the description lines:
      • 0: the documentation is generated before the Data Element description lines.
      • 2 4 5 6 7 8 .. : the documentation is generated after the error message of the indicated type.
    • Associated explicit and help messages:
      Number of the automatic explicit error message, or number of the explicit error message.
      Note: For a record with an I entity type, this number is automatically managed. It contains the line number of the erroneous field on the Screen.
5 3 Line number:
This number is automatically managed:
  • 000: error messages
  • 001-999: help messages
Note: For a record with an I entity type, this number is automatically managed and contains the column number of the erroneous field on the Screen.
6 1 Error gravity:

An E standard error gravity is associated with each automatic or explicit error message.

A W standard error gravity is associated with each warning entered for an error message.

7 30 Error message - First part:
This part of the message indicates the error type for automatic error messages in the following manner:
  • 2: Invalid absence for the field
  • 4: Non-numerical class field
  • 5: Invalid value for the field

You can modify it.

For an explicit error message, it is the first part of the message indicated in the Description field on the -GE Lines (first 30 positions).
Note: For a record with an I entity type, this number is automatically managed. It contains the position of the corresponding Data Element in the description of the Screen.
8 36 Error message - Second part:

For an automatic error message, it is the Data Element name.

For an explicit error message, it is the second part of the message indicated in the Description field on the -GE Lines (position 31 to the end).

Figure 1. Sample of a record
GCCHJIE0100054000ENON-NUMERIC CLASS DATA ELEMENT ACTION 
LU1IDO000116 002 009
In this record, you can see the:
  • Library code: GCC
  • Entity type: H
  • Instance code: JIE010
  • Error number: 0054
  • Line number: 000
  • Error gravity: E
  • Error message: NON-NUMERIC CLASS DATA ...

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)