DtvLong dal_mes_rea (str)

Reads the active message from the message window or the message to the transferred message name from the data base or from the local data structure.

Input Parameters Significance
none -

Output Parameters Significance
char *str active message in the message window or by transfer of $MESSAGE NAME: message text from T_MESSAGE

Return Code Significance
0 no error
1 message module not initialized
2 no message active
3 no message found to MESSAGE NAME

When call the function without transfer of $MESSAGE NAME you must have already output a message in the message window.

If you already output several messages in the message window below each other, the function reads the last row in the message window only.

In the calling program have to be allocated enough free storage place.