Home

KB0115

Caché Control Panel's Process Debug Facility is Unavailable on Some Platforms

Applies to: Serenji on Caché 3.x and 4.x

Symptoms

When connecting to Caché on Windows, debugging with Serenji can be initiated by right-clicking on the user process in the Caché Control Panel, and choosing "Debug".

However, when Caché Control Panel connects to a non-Windows based server, the "Debug" option fails to interrupt the process and connect it to Serenji.

Cause

Prior to Caché 5, Control Panel's Process Debug feature has not been implemented for non-Windows Caché servers. This functionality is supplied by InterSystems and is not available irrespective of whether Serenji is installed or not.

Solution

Upgrade to Caché 5.

Notes

This facility requires Caché Control Panel. Starting with version 5.1, Control Panel was replaced by System Management Portal which does not implement Process Debug.

In order for Serenji to exploit the Process Debug facility, the appropriate one of the following conditions must be satisfied:

  • On Caché 4.0 or later, the routine %ZDEBUG must have been restored into the %SYS namespace. This routine is present in the CACHE.RSA file, which should have been loaded when Serenji support was installed onto your server.
  • On Caché 3.x, you must have run the following command in %SYS after loading the support routines: do Install^%SerenjC31

Otherwise, Caché's default command-line debug facility will be triggered.

Last reviewed: Jul 22, 2009

Back to Serenji Knowledge Base Articles