Skip to main content


Specify programmer mode response to the BREAK command.


[Miscellaneous]    BreakMode=n

n is either 1 (true) or 0 (false). The default value is 1.


InterSystems IRIS® data platform programs can execute in two modes, depending on how InterSystems IRIS is entered: application mode and programmer mode.

BreakMode controls how an InterSystems IRIS process in programmer mode responds when it encounters a BREAK command that has no argument. When BreakMode is enabled (n = 1), InterSystems IRIS enters the debugger or returns to the direct mode prompt with a <BREAK> error. When this parameter is not enabled, the BREAK command is ignored.

Application mode jobs always ignore argumentless BREAK commands.

Changing This Parameter

On the Compatibility page of the Management Portal (System Administration > Configuration > Additional Settings > Compatibility), in the BreakMode row, click Edit. Select BreakMode to enable this setting.

Instead of using the Management Portal, you can change BreakMode in the Config.Miscellanous class (as described in the class reference) or by editing the CPF in a text editor (as described in the Editing the Active CPF section of the “Introduction to the Configuration Parameter File” chapter in this book).

To change this parameter for a single process only (as opposed to instance-wide), use the BreakMode() method of the %SYSTEM.Process class. See the class reference for details.