Eduard Lebedyuk · Jun 18, 2020 1m read

Debugging Business Operations

Often we need to debug a Business Operation. Tracing and logging work but sometimes you want to work with a BO as with your local terminal session.

Here's how you can do that on any operating system.

Windows has a great tool for debugging Business Operations - Foreground mode. In that mode Windows launches a local terminal with operation job.

Note that there's  an issue with some InterSystems IRIS versions which caused cterm launch instead of iristerm. To fix that you can either install Caché/Ensemble/HealthShare on a same server or run this reg file:

Windows Registry Editor Version 5.00

"URL Protocol"=""

@="\"C:\\Program Files (x86)\\Common Files\\InterSystems\\IRIS\\bin\\iristerm.exe,1\""


@="\"C:\\Program Files (x86)\\Common Files\\InterSystems\\IRIS\\bin\\iristerm.exe\" %1"

Replacing the path to iristerm.exe with a locally correct one.

Linux does not have official Foreground mode but here's a workaround (at your own risk).

1. Start the Operation with PoolSize=1 and NOT in Foreground mode.

2. Find PID for this BO (Jobs tab).

3. Start new irissession and type:

Do $system.Process.Terminate(<BO JOB>)
Do ##class(Ens.Job).Start("BO CONFIGNAME", 1)

And your terminal becomes an Interoperability  BO.

0 1 0 142
Log in or sign up to continue