Rational Programming Patterns for System z

-GE Lines in Segments

You can declare explicit error messages on a Segment or replace automatically generated error messages on the elements called on the -CE Lines of a Segment.

In the -GE Lines of the -G Lines tab of the Data Structure and Segment editors, you can declare explicit error messages. You modify or enter error messages in the -GE Lines of the -G Lines tab assigned to the Data Element calls in the -CE Lines tab. Click the -GE Lines subtab to display the table with the Type, Description, and Link fields.

The values to enter in the Type and Description fields depend on the task you want to perform. The Link field is to be used when calling a Text, to select the Text instance.

Error
This column displays a dot on all the existing description lines which are not empty.

Moreover, if this line is not correct, this column also displays an error or warning symbol, depending on the error gravity. A hover help indicates the source of the error.

Type
Select one of the following values:
Table 1. Available line types
Values Comments
T Call of a Text section.
* Line which is not to be generated. It is used to insert a comment or an override.
S Replacement of an automatic error message.

An automatic message can be replaced with a specific message such as: THE ORDER NUMBER IS REQUIRED Specific messages are indicated on S-type lines assigned to Data Element call lines (-CE Lines tab) in the Segments.

D Help messages.
Description
You can modify the error messages which are generated for the current entity and generate help messages in the same format.
Table 2. Specification of the description field
Type Description
D To complete the error report with extra documentation, enter D in the Type field, and code the Description field:

Position 1:

  • 0: Message before an element description.
  • 1: Message after an element description.
  • 2–5: Message after an error message of type 2 - 5.

Position 2: blank

Position 3:
  • blank = help message
  • T = call of a Text

Position 4: blank

Position 5: beginning of the help message or codes of the called Text and paragraph. Two asterisks (**) for the paragraph code call all the paragraphs of the Text.

S To override a message, enter S in the Type field, and code the Description field:

Position 1: error type (2, 3, 4, or 5)

Position 2: blank

Position 3: error gravity (E, C, or W)

Position 4: blank

Position 5: enter the help message, or Text and paragraph codes.

Link
You use this field when calling a Text ('T' type line). Click the icon located in this field to display a selection wizard.

The selected instance is then automatically displayed in the Description field.

The Description field can be modified for a Text call, in order to indicate generic codes.

Notes:

The Text calls for the documentation are aligned according to a standard print layout.

All the Text calls are aligned (except if the non-alignment $$ parameter was used). The $n print windows indicated in the Text are respected. If they are not specified, the default print window ($0) is used.

All the text processing options are functional (underlining, negative indentation...).

Line skips are specified in the Text, but limited to a three-line skip (line skips greater than three become three-line skips); page skips become three-line skips. By default, the skips are one line, except for print windows $0 and $1, where they are two lines.

After you have specified your error messages, you must generate them.


Terms of use | Feedback

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