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.



This parameter has been retained for compatibility, but should not be used when building new applications.

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.MiscellanousOpens in a new tab class (as described in the class reference) or by editing the CPF with a text editor.

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

FeedbackOpens in a new tab