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 |
/Noconsole
|
Output only to the Log-window and not to the Console window. | |
/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).
|
|
/Error
|
Write the prefix Error! - before each text line.
|
|
/Warning
|
Write the prefix Warning! - before each text line.
|
|
/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 |
|
Result Result= res
|
With this option the result value to be returned with the /X option can be specified. If the value res is not supplied, an empty string ('') is returned. | |
RESULT | description | |
undefined | if /X is not supplied
| |
'res' or '' | if /X is supplied; the value is returned to the macro selected by the level n specified with the option /X .
|
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