Enable trace for the OnDemand Load Data service in Content Manager OnDemand

Answer

With Content Manager OnDemand V9.5.0.2 and later, the service can be modified with the OnDemand Configurator to enable trace.

The trace parameters are the same as what you enter on the command line for ARSLOAD, which are the -1 and -2 parameters:

-1 <trace_file> Fully-qualified trace file name
-2 <trace_level> Trace level

First, make sure the OnDemand Load Data service is stopped. Next, bring up the Properties sheet of the service. Add trace parameters to the Parameters field as shown below. Click OK to save the change and restart the service. That is all that is required.

Note: If you are running Content Manager OnDemand V9.5.0.2 or later, you do not need to follow those steps below. The following information is applicable to OnDemand V9.5.0.1 and V9.5.0.0 only.


To enable trace for the OnDemand Load Data service for Content Manager OnDemand V9.0, you need to modify the Content Manager OnDemand portion of the registry and specify the additional trace parameters first. Then, the OnDemand Load Data service must be uninstalled and reinstalled so that those new parameters can be added to the Windows service registry. These steps are described in detail below.

On Windows, the Content Manager OnDemand portion of the registry can be found in the following registry path:

HKLM\SOFTWARE\IBM\OnDemand for Windows

Step 1

Add additional trace parameters to the ProgramParms registry value at the registry path as shown in the following example:

HKLM\SOFTWARE\IBM\OnDemand for Windows\@SRV@_ARCHIVE\Services\arsload (ARCHIVE)\ProgramParms

For example, the current ProgramParms registry value might contain the following settings:

-I ARCHIVE -u username -p password -t 60 -G FORMS -d c:\ARCHIVE\arsload

You could add -1 c:\trace.log -2 ALL=15 so that the ProgramParms registry value contains the following:

-I ARCHIVE -u username -p password -t 60 -G FORMS -d c:\ARCHIVE\arsload -1 c:\trace.log -2 ALL=15


Step 2
Start the OnDemand Configurator and select the Services branch. Make sure that the service named "OnDemand Load Data (ARCHIVE)" is stopped (where ARCHIVE is the name of your Content Manager OnDemand instance). Right-click the OnDemand Load Data service and click Deinstall. The status should change to "Not Created."

Right-click the OnDemand Load Data service again and click Install. Enter the same user ID and password that was used to create the service initially.

Restart the service. After you restart the service, you should begin generating trace data.

Important: The ProgramParms registry value is updated automatically when the instance is updated or the OnDemand Load Data service is updated. During the update, the additional trace parameters you entered will be lost. It is very important to perform Step 2 immediately to avoid this problem.

When Step 2 is performed, the following Windows service registry entry is updated with the new trace parameters. Updating this registry entry directly is not recommended. If you decide to do so, be aware of the risk of potentially altering other Windows services by mistake and rendering the whole system unstable.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OnDemand Load Data (ARCHIVE)\ImagePath