ADELIA |
VADELIA |
|
WADELIA |
MADELIA |
(I) |
(I) (C/S) |
|
(I) (C/S) |
(I) (C/S) |
Warning: In the case of ADELIA programs, this instruction is used in "error message subfile" mode.
Section for use
VERIFICATION and procedure
Syntax
INIT_MSG SeriesVarId
SeriesVarId |
Þ |
SeriesVarId VarId | VarId |
Description
This instruction is used before the ANOMALY, ERROR, or WARNING instructions.
It is used for loading messages with variables which are defined in the message by &1, &2... up to &5.
The information is transferred to the message variables SeriesVarId according to position: the first variable after INIT_MSG moves to the &1 variable in the message.
The &1 to &5 variables must be of the same type and length as the corresponding variables that follow INIT_MSG.
If you amend an existing message with variable fields, it is not necessary to recreate the former models. The message will merely have a blank in place of the new variable.
This instruction must be placed after the PREPARE_MSG instruction which defines the message to be personalized.
Warning: If the INIT_MSG instruction is placed before PREPARE_MSG (or PROCEDURAL_RULE), the corresponding instructions will not be generated in the corresponding 3GL.
The instruction is authorised in a procedure only if it is directly called from a VERIFICATION paragraph. In this case, the graphical object specified in the PREPARE_MSG instruction must be described by the name of its window or page and must belong to the window (or page) corresponding to the VERIFICATION paragraph which called the procedure.
Example
PREPARE_MSG PRD0013 Z_PAYMENT_CODE
CHAIN PAYMENTS
IF PAYMENTS DOES_NOT_EXIST
INIT_MSG Z_PAYMENT_CODE P_COMPANY
ANOMALY
END
Message PRD0013 contains the value of the wrong payment code and the company code because they are defined in the error message as &1 (2 characters, alpha) and &2 (3 characters, 0 decimals).