UM or EM - Display a User-Message (UM) or Error-Message (EM)

From STX Wiki
Jump to navigation Jump to search
UM text [; title ]
Display the argument text in a message box with caption title (default: UM) and the only button OK. This function is a shortcut for BUTIL MSGBOX MSG.
EM [ rc=-1 [ level=2 ]] ; text [; title ] 
Display the string ERROR (rc): text in a message box with caption title (default: EM) and the only button OK. When the dialog is closed use the command EXIT level INT rc to return from level macro levels.
argument description default
text The message text to be displayed.
title The caption of the message box. UM or EM
rc The return code of the EM function. This must be an integer number. -1
level The number of macro levels to be closed (see command EXIT for details) 2 (return to caller)
RESULT description
undefined for the function UM
rc for the function EM (value is returned to the macro defined b< level)

Example:

[macro umemtest]
um press OK key to continue; UM - waiting for user input
em 107; press OK to exit this macro with return code 107; EM - waiting for user input
// this point should nevel be reached!
conlog '$#mac: you should never see this message - something goes wrong!'
exit 1 int 0