Command: errlog

Syntax

errlog

Description

Display the error log window.

Parameters

None

Switches

ch=<chan>
Send error output to a text channel already open for output. Such direction of output does not interfere with any output to the errlog log or monitor window.
-cl
Clear the contents of the error log window. Note: this does not clear the contents of the retained log.
-fo=<font>
The font to be used in the window. This must be a fixed font. If omitted a default font is used.
-k
Make sure the error log file is retained at the end of the session. The default behavior is to delete it.
-ic
Open the window iconic, or iconize it if it is already open. Omission of this switch will de-iconize the window if it currently iconic.
-inv
Hide the error log window, i.e. make it invisible. If this switch is not present the window will be made visible.
-mon
Direct error output to the monitor window instead of the error log window. The -no_mon switch will revert to using of the error log window, the default behavior. When this switch is present all other switches are ignored.
-pos=<screen_xy>
X,Y screen position for the window. The default is 200,0.
-q
Quiet mode. By default, when an error occurs and the error log window is iconised a warning bell is issued. The presence of this switch suppresses this behavior, which may mean that errors or warnings go unnoticed. Omission of this switch will leave quiet mode in its current state, which is initially off. See also error_beep, by which the warning bell (aka beep) can be suppressed on a permanent basis.
-r=<num>
The maximum number of lines displayed in the error log. The default is 128. This the number of lines retained for window scrolling purposes and does not change the size of the window, nor the number of visible rows, which is 10 on window creation. Irrespective of this value, the error log text is held in a buffer of 32k bytes, which may restrict the line count. 32K is also the maximum size of the disk file with only the tail of the log being retained. If you wish to retain all error output which may exceed the 32K, use the -ch switch, see example below.
-tb
Display the window icon in the Windows taskbar. The default behavior is not to display it in the taskbar but only to display it on the desktop when minimized. This switch has no meaning on Unix systems.

Notes

The error log window displays language errors encountered during command execution.

Irrespective of whether or not the error log window is open, language errors are directed to a log file named mxerr<pid>.log, where <pid> is the Fire process-id. This file will be located in the logs directory, or $MXTEMPDIR if the logs directory does not exist.

Language errors are directed to the terminal monitor when command echoing is active.

Other output can be directed to the error log by the -err switch applied to the following commands: tell, dir, glist, history, idir, list, type, wlist.

When an error occurs and the error log window is not present (or iconised and not in quiet mode), a warning bell (beep) is issued. This behavior can be suppressed by errlog -q, or via the system identifier error_beep.

The typing of Control E in any window will invoke the command errlog, thus making it visible.

Examples