Copyright © Cloud Software Group, Inc. All Rights Reserved

Debugging

IMPORTANT - For some system messages, the Action section recommends that you turn debugging on to assist in resolving the problem.

You may need to capture debug information either:

•	for one or more iProcess Engine server processes or,

•	for the staffifc.exe (on Windows) or Pstaffifc (on UNIX) process. This process is called by the SWDIR\bin\swutil command.

Before using debugging, you should be aware of the following:

•	Enabling debugging for iProcess Engine server processes can have a significant impact on system performance, particularly for processes such as the Background (BG), Work Queue Server (WQS) or Work Item Server (WIS).

•	Enabling debugging for the staffifc.exe (on Windows) or Pstaffifc (on UNIX) process means that SWDIR\bin\swutil commands will take longer to run. It will not affect the performance of the iProcess Engine server processes.

•	Whenever possible, enable debugging at a time that will minimize the impact on system performance.

•	Always disable debugging again immediately after you have obtained the necessary debug data.

•	Debug files are created in the SWDIR\logs directory. Depending on the debug settings used, debug log files can be extremely large. Ensure that the system has adequate disk space available before enabling debugging, and remove the debug log files as soon as they are no longer needed.

•	Use debugging only when you are explicitly advised to do so, either in this guide, or by TIBCO Support.

Enabling and Disabling Debugging

The following sections explain how to enable and disable debugging for each type of process.

Debugging iProcess Engine Server Processes

To enable or disable debugging for an iProcess Engine server process, use the SWDIR\util\swadm command to set the DEBUG process attribute, using the required debug string.

If the debugging is disabled, the MEMSET debug string will be applied to record the debug information to the .dmp log file, which is located in the SWDIR\logs directory. The default MEMSET debug strings for each iProcess Engine server process is as follows:

Process	Default Debug String
BG	MEMSET,ALL=1,G=13,c=15,T=3,m=41,q=57
BGPREDICT	MEMSET,ALL=1,G=13,c=15,T=3,m=41,q=57
DLMGR	MEMSET,ALL=1,G=13,T=7
RPCBG	MEMSET,ALL=1,G=13,T=7,c=15,q=57
RPC_POOL	MEMSET,ALL=1,G=13,T=7,q=57
RPC_TCP_LI	MEMSET,ALL=1,G=13,T=7,q=57
RPC_UDP_LI	MEMSET,ALL=1,G=13,T=7,q=57
SPO	MEMSET,ALL=1,G=13,m=41,q=57,Q=5,v=5,E=5
WIS	MEMSET,ALL=1,G=13,m=41,R=5,w=5,Q=5,T=3
WISMBD	MEMSET,ALL=1,G=13,m=41,T=7,q=57,Q=5
WQS	MEMSET,ALL=1,G=13,q=57,T=5,R=5
PROCMGR	MEMSET,ALL=1,G=13,q=57,T=7

See the individual system message descriptions for details of the debug string that is required when investigating a particular error.

See Administering Process Attributes in TIBCO iProcess Engine Administrator's Guide, for more information about the SWDIR\util\swadm command.

Debugging the staffifc.exe (Windows) Process

To enable debugging for the staffifc.exe process, put the required debug string in the following registry key:

HKLM/SOFTWARE/Staffware plc/Staffware Server/Nodes/nodename/DEBUG

where nodename is the iProcess Engine node name.

Refer to the individual system message descriptions for details of the debug string that is required when investigating a particular error.

To disable debugging for the staffifc.exe process, delete or blank the value of the DEBUG registry key.

Debugging the Pstaffifc (UNIX) Process

To enable debugging for the Pstaffifc process, put the required debug string in an environment variable called DEBUG, then export DEBUG.

Refer to the individual system message descriptions for details of the debug string that is required when investigating a particular error.

To disable debugging for the Pstaffifc process, delete the DEBUG environment variable.

Copyright © Cloud Software Group, Inc. All Rights Reserved