ctmfw utility - Usage as a Service

As a service, ctmfw takes its parameters (rules) during startup from the rull.dat file whose full path name is specified in <Control-M/Agent>\data\ctmfw.cfg.

To change one or more rules, change the contents of the rull.dat file. The rull.dat file provided with Control-M/Agent is a sample file and must be changed to reflect your requirements. The full path name to the ctmfw.cfg configuration file must be specified under the following Windows registry key that is generated automatically by the installation script:

HKEY_LOCAL_MACHINE\SOFTWARE\BMC Software\CONTROL-M/FileWatcher\SYSPRM\File Watcher Configuration File

The default value for this key is <CONTROL-M/Agent_install_directory>\DATA\ctmfw.cfg

NOTE: You need administrative permissions to update the registry key. It is recommended that this default value not be changed.

The configuration file must contain the following line:

-input <ruleFileName>

The variable <ruleFileName> is the full path name of a rule file containing the File Watcher rules. For an example of a sample rule file, see Sample Rull.dat file.

The FileWatcher service running under the local system account cannot detect network resources (files located on remote systems). If you want the FileWatcher to detect network resources, configure the FileWatcher service to run under a regular user account instead of Local System Account.

When running as a service, ctmfw generates an execution log file. This file is saves in the Control-M/Agent proclog directory under the following name:

U_CTMFW_<process_id>.log

For an example of the trace file output, see Trace file example.

By default, logs in the proclog directory are retained for 1 day. If the maximum days to retain output files parameter is set to a number higher than 1, logs are retained for the number of days specified in that parameter.