Skip to main content


Write to the messages.log file, the operator messages log.

Background Information

InterSystems IRIS reports general messages, system errors, certain operating system errors, and network errors through an operator console facility. On Windows, there is no operator console as such and all console messages are sent to the messages.log file in the InterSystems IRIS system manager directory (install-dir/mgr). For InterSystems IRIS systems on UNIX® platforms, you can send operator console messages to the messages.log file or the console terminal.

For more information, see “Monitoring Log Files” in the chapter “Monitoring InterSystems IRIS Using the Management Portal” in the Monitoring Guide.

The directory location of this file is configurable; see the ConsoleFile entry in Configuration Parameter File Reference.

Available Tools

Provides the WriteToConsoleLog() method, which you can use to write to the messages.log file.

Availability: All namespaces.

Provides the ModifyConsoleFile() method.

Availability: All namespaces.

^LOGDMN routine and SYS.LogDmn class

Enable you to set up structured logging, which will write the same messages seen in messages.log to a machine-readable file that can be ingested by your choice of monitoring tool. See the article “Setting Up Structured Logging.”

Availability: %SYS namespace.


The special variable $SYSTEM is bound to the %SYSTEM package. This means that instead of ##class(%SYSTEM.class).method(), you can use $SYSTEM.class.method().