The Listener can be configured using the PchConfig.properties configuration file. This file is available in the IDM installation directory. The Listener provides default values for all its configuration parameters. If you wish to override these defaults, then you can edit the configuration file that will be read when the Listener object is instantiated. The default port used by a Listener is 32775. For cases where only few ports are enabled for communication, a different port for the Listener can be assigned using the configuration file. In addition, if more than one Listener-enabled applications are running on the same computer, only the first one of them, called the primary Listener, will be able to bind successfully to that particular port. Any secondary Listeners will fail to get that port, in which case, they shall bind to a different port, then contact the primary Listener and inform it of the port they have chosen. You can configure this secondary Listener using the secondary_port parameter in the configuration file.
There are four possible properties that can be configured using this file, listed in the following table:
Property Name | Default | Description |
---|---|---|
port_number | 32775 | The primary TCP port number on which the Listener will listen for connections from Managers. It would require changing if another service is already using this port. |
secondary_port | OS defined | The first Listener on a host will acquire the Listener port (defined by port_number); others will by default bind to OS-defined ports. If this configuration parameter is specified, then secondary Listeners will instead try this port number, then that plus 1, plus 2, and so on, until they successfully bind to a port. |
output_interval | 900 | Specifies the aggregation interval in seconds. |
output_count | 96 | Specifies the maximum number of summary blocks that will be written to the summary log before it is closed and a new one opened. The default configuration provides for 24 hours’ worth of data to be written to a single file, and so between 24 and 48 hours’ history will be available at any given time. |
port_number=32775 secondary_port= output_interval=900 output_count=96
Note: To view the data captured by FileNet System Manager Listener, you need to install and configure the FileNet System Manager Dashboard monitoring tool. For information regarding installing and configuring the FileNet System Manager Dashboard tool, refer to FileNet System Manager Dashboard help or log on to CSS Website for customer support.