Rational Developer for System z, Version 7.6

-GE Lines section

You use the section to declare explicit error messages on a Segment or to replace automatically-generated error messages on the elements called on the -CE lines of a Segment.

The -GE section in the -G tab of the Data Structure and Segment editors enables you to declare explicit error messages. You modify or complete error messages in the -GE section of the -G tab assigned to the Data element calls in the -CE Lines tab. The Click the downward arrow to view a table with the Type, Description and Referenced text fields.

The values to enter in the Type and Description fields depend on the task you want to perform.

You can use the Referenced Text field to specify a whole Text or some of its paragraphs. It constitutes a guided input but you can also indicate a Text directly in the Description field.

Type
Enter in this field, one of the following values:
Values Comments
T Call of a text section.
* Line which will not be generated. It is used to insert a comment or an override.
S Replacement of an automatic error message.

Automatic messages can be replaced by specific messages such as: 'THE ORDER NUMBER IS REQUIRED These messages are indicated on 'S' type lines assigned to data element call lines (-CE lines tab) in the Segments.

D Documentary messages.
Description
You can modify the error messages which are generated for the current entity and generate documentation messages of the same format.
Type Description
D

To supplement the error report with extra documentation, enter 'D' for the TYPE OF LINE, and code the DESCRIPTION field as follows:

Position 1:

  • 0 : Message before Element Description.
  • 1: Message after Element Description.
  • 2–5 Message after an error message of type 2 to 5.

Position 2: blank

Position 3:
  • blank = a documentary message
  • T = the call of a text

Position 4: blank

Position 5: Begin the documentary message or Enter the text and paragraph code being called. Two asterisks (**) for the paragraph code is a permitted value, it will call all the paragraphs of the text.

S

To override a message, enter 'S' for TYPE OF LINE, and code the DESCRIPTION field as follows:

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 documentary message, or text and paragraph codes.

Referenced Text
On a T-type line, you can call a section of an existing text, to do that, you can:
  • Either enter a T in the Type field, press Enter, and then click in the Type field again. And then, the Change button of the Referenced Text field becomes available. Click on it to open the selection box which displays the Texts already present in the current location. Click the + sign in front of a Text to be able to see its paragraphs. Select one and click OK. The selected Text and paragraph will be inserted in the Description field.
  • Or enter a T in the Type field and specify the Text code directly in the Description field with the following format:
  • Positions Contents
    6 - 11 Code of called Text
    12 - 13 Code of the selected paragraph, or ** to select all paragraphs
Note:

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

All the Text calls are justified (except if the non-justification $$ 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, etc.).

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.

The same Text can then be used in the 'on-line' documentation and in the user manual of the application.

Once 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)