Programmer Guide/Macro Library/UM

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 MSGBOX MSG; text [; title=UM].

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