Home

KB0020

How do I Use Serenji to Debug a Background Job?

Applies to: Serenji

Caché

If you are using Caché prior to version 5.1, the simplest way is to use Serenji's integration with the Caché Control Panel. (If you are still using Caché 3.x, you will first need to set this up using the instructions which are given in Serenji's help file.)

When you are ready to debug, open the Caché Control Panel for the appropriate server and choose the 'Processes' folder. Right-click on the job you wish to debug and select Debug.

Other Servers

For MSM or DSM, or on systems where Caché's Control Panel debug feature isn't available to you:

The simplest approach is to modify your background job's code so that it runs through DEBUG^%Serenji. For example, write a container routine such as:

bckdebug ; D DEBUG^%Serenji("^BCKGRDJOB","1.2.3.4") Q

where "1.2.3.4" is the IP address of your Serenji PC.

Then run your container routine in the background:

job ^bckdebug

Alternatively, if you can instruct your running background process to execute some extra code, you can enable and disable debugging. An example of this technique is in WEBLINK^%Serenji, where it calls ENABLE^%SerenjD and DISABLE^%SerenjD.

Last reviewed: Nov 9, 2004

Back to Serenji Knowledge Base Articles