Access
To display, create or modify the error messages of the current application area, select either:
the corresponding option in the context-sensitive menu (or the equivalent button) in the Error messages tab of the Object manager.
the corresponding option in the context-sensitive menu of the Repository - Error messages dialog box of the 4GL Editor.
Data entry
Number
Length: 4 positions maximum.
Mandatory entry.
Prefix
This prefix must be a valid prefix name (as defined by IBM).
Length: 3 characters maximum.
Optional entry.
Severity code
The severity code must range between 0 and 99.
Default: "0".
Optional entry.
Description
Length: 50 characters maximum.
Default: the first 50 characters of the first-level message.
Optional entry if a first-level message was specified.
Level 1 message
Text of the first-level error message.
This text can contain one or several substitution variables (&1 to &5), which must mandatorily be defined in the "Substitution variables" section below.
The &N sequence serves to define a carriage return (not accepted in Visual Adelia applications when the message is not displayed in *BOX or "integrated" mode, as well as in iSeries applications).
Length: 132 characters maximum.
If no message is entered here, the description text will be retained as first-level message.
Optional entry if a description was specified.
Level 2 message
Text of the second-level error message.
This text can contain one or several substitution variables (&1 to &5), which must mandatorily be defined in the "Substitution variables" section below.
The &N sequence serves to define a carriage return.
Length: 512 characters maximum.
Optional entry.
Substitution variables
The error message can contain up to five substitution variables which must be defined here, from number 1, then by successive order.
Type
Type of the substitution variable.
Possible values:
- Alphanumeric
- Numeric
- Binary 2
- Binary 4
- Binary 8: This type is not supported on AS/400
- Date: This type is not supported on AS/400
- Time: This type is not supported on AS/400
- Timestamp: This type is not supported on AS/400
Length
Length of the substitution variable.
It must be less than or equal to 15 for a numeric variable.
Nbr of decimals
Number of decimal positions of the substitution variable.
Alphanumeric variables: this field must be left blank.
Numeric variables: mandatory entry (from 0 to 9; it must not exceed the number of characters of the variable).
______________
Buttons
Information
This button opens a dialog box displaying information on the current error message, such as the name of the software engineer-owner, the dates and times of creation and modification.
Enter/Create/Modify (validation)
The Enter button (in display mode) closes the dialog box.
The Create button (in creation mode) or Modify button (in modification mode) validates the dialog box.
The various fields of the dialog box are verified. If all are valid, the error message definition is updated in the database before the box is closed; otherwise, an error message is displayed.
Cancel
This button closes the dialog box without validating the choices made.
Keyboard shortcut: Esc.