ConvertBot: Graphical display of all messages from within a macro

2020-04-27T22:04:56Z

Graphical display of all messages from within a macro

New page

Graphical display of all messages from within a macro
<pre>
<UNUSED>
<UNUSED>
<ROWS> Number of rows in window [DEF=20]
<COLS> Number of columns in window [DEF=132]

MESSAGELOG creates a window in which text messages are displayed. Typically it
is used to display informational, warning, or error messages from a macro. The
message display includes message type, date/time and message text color-coded
by severity: white for informational messages, yellow for warning messages, and
red for error messages.

Which severity levels are displayed is controlled by the on-off toggle buttons
"Error On", "Warning On", and "Info On" located at the bottom of the window.
These settings can be modified interactively by clicking on the buttons to
toggle them on and off. (These buttons do not control the messages being
recorded to a logfile.)

MESSAGELOG must have an /id=n switch, so that it can receive messages.

Macros send messages to MESSAGELOG, as shown in this sample macro:

startmacro
pipe on
messagelog/id=msglog/msgid=main/file=temp
res SEVERITY 2
message send msglog ,, LOG ,SEVERITY, "THIS IS AN ERROR MESSAGE"
res SEVERITY 1
message send msglog ,, LOG ,SEVERITY, "THIS IS A WARNING MESSAGE"
res SEVERITY 0
message send msglog ,, LOG ,SEVERITY, "THIS IS AN INFO MESSAGE"
pipe off
endmacro

Severity levels are: 2=Error, 1=Warning, 0=Informational

The /FILE=filename is an output file in ASCII format which contains all messages
sent to MESSAGELOG. All severity levels are written to this file regardless of
the severity levels being displayed on the window. The /FILE switch is
optional.

MESSAGES:
Receive:
BUTTON - Handle a button press
EXIT - Exit this primitive
LOG - Handle a log message of type INFO, WARN or ERROR
LOGSTATUS - Handle a log status message
REFRESH - Handle a refresh
RESIZE - Handle a resize

SWITCHES:
/BUFFER - force unbuffered I/O on the log [DEF=TRUE]
/ERROR - turn on or off visibility of error messages [DEF=TRUE]
/FILE=filename - name of file to write messages [DEF= no file]
/INFO - turn on or off visibility of info messages [DEF=TRUE]
/THEME=theme - Set the theme of the window
/TITLE=title - Set the title of the window [DEF="NeXt Midas Message Log"]
/WARN - turn on or off visibility of warning messages [DEF=TRUE]
/WIN=regname - name of panel in registry to host the message log window.
If not specified, a new Frame is created.

</pre>

[[Category:NXM_Explain]]

MESSAGELOG - Revision history

ConvertBot: Graphical display of all messages from within a macro