char dal_mes_prm (nam, st1, st2, st3, flg)

Outputs the message for a message name into the message window. The additional entries are inserted into the message at run-time (at the positions of the place-holders > %s < ). Additionally, a user input is requested.

Input Parameters Significance
char *nam message name [0 = direct output]
char *st1 1. additional string [0 = not defined]
char *st2 2. additional string [0 = not defined]
char *st3 3. additional string [0 = not defined]
char flg control flag:
'I' = information (input: OK)
'W' = warning( input: OK, CANCEL)
'Q' = request (input: YES, NO)
'C' = confirmation (input: YES, NO, CANCEL)

Output Parameters Significance
none -

Return Code Significance
value Id for user input:
'Y' = YES
'N' = NO
'O' = OK
'C' = CANCEL
0 no message ouput, because:
message module not initialized
message output switched off
no graphical client loaded.

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 parameters st1.

Behind the message text in T_MESSAGE or in st1 you can specify in square brackets which button is to get the focus in the message window (default button). This information is separated from the message text by spaces.

Message text [Button_shortcut]

Possible button shortcuts are YES, NO, OK or CANCEL.

Note! This function uses Windows resources to display the message window. For this reason texts on buttons depend on the language version of the client operating system and not on the language setting of the DataViews server.