DtvLong dal_mes_wri (nam, st1, st2, st3)

Writes the message of a message name into the message window. The additional entries are inserted into the message at runtime. (at the placeholders > %s < ).

Input Parameters Significance
char *nam message name [0 = direct output]
char *st1 1. additional entry [0 = unassigned]
char *st2 2. additional entry [0 = unassigned]
char *st3 3. additional entry [0 = unassigned]

Output Parameters Significance
no -

Return Code Significance
0 no error
1 message module not initialized
2 message output disabled

The message must be contained in the system entity T_MESSAGE.

If you pass a zero pointer as message name, DataView will directly output the text passed in the parameter st1.

Each message occupies one row in the message window. You can output several messages in the message window below each other if you defined a multi-line message window via the dal_mes_set function.

Messages that get longer than one row because of additional entries are correctly broken into lines by DataView. However, the message window is not automatically scrolled upward, so that the user may only see the first line. For this reason you should prefer short messages.