ConLog - Write messages to the Console and/or the Log-window

From STX Wiki
Jump to navigationJump to search


CONLOG [line1 [line2 ..]] [ options ]
Write the specified text-lines (line1, ...) to the Console window and/or the Log-window. This function can be used by scripts to write error- and progress-information to the Console. It
argument description default
line1, line2, ... The text lines to be written to the window(s).
option description default
/Shell Write the prefix "appid:currtime - " before each text line. Where appid is the value of variable AppName and currtime is the current time (hh.mm.ss).

-

/Shell Write the prefix "appid:currtime - " before each text line. Where appid is the value of variable AppName and currtime is the current time (hh.mm.ss).

UM or EM

rc The return code of the EM function. This must be an integer number. -1
/X
/X=n
Exit from n macro levels. If /X (eXit) is supplied without a number, the number of levels n is set to 2 (return to caller).

(see command EXIT for details)

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

Navigation menu

Personal tools