4.2 Starting an F/X Monitor

The F/X Monitor is delivered in the /OperationsCenter_install_path/html/classes/fxmonitor.jar file. It can operate in any Java 1.5 (or above) Runtime Environment. There are no license requirements for the operation of an F/X Monitor; only F/X adapters are licensed.

To start the F/X Monitor, issue the following command:

java -jar fxmonitor.jar ‑c configuration_filename_and_path ‑l logging_configuration_filename_and_path [‑m monitor_name] [‑s signal_file_directory]

where:

The command arguments are as follows and can be listed in any order:

  • -c: Specifies the F/X Monitor XML configuration file for F/X Monitor operation. The full file path is required.

    For information on configuration files, seeSection 4.5, F/X Monitor Configuration File.

  • -l: Specifies the log4j compliant configuration file for logging. The full file path is required.

    For information about logging, see Section C.0, Logging Configuration File.

    For a full set of return codes, see Section A.0, F/X Monitor Return Codes.

  • -m: (Optional) Specifies the monitor name to identify the F/X Monitor session so that it can be closed at some future point in time. Monitor Names must be unique on a given host system—a call to start a session.

  • -s: (Optional) Specifies the directory for storing monitor signal files. If unspecified, uses the default temporary directory of the operating system that the monitor runs on:

    • Windows: c:\documents and settings\administrator\local settings\temp

      Using the default can be a problem for Windows implementations where group policy prohibits access to local user \temp directories.

    • Unix: /tmp

For example:

java -jar fxmonitor.jar ‑c D:\MyConfig\config.xml ‑l D:\MyLogs\logging.xml ‑m MyMonitor