Configure System Manager Listener

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.

To set the System Manager Integration Listener properties

  1. From a text editor, open the PchConfig.properties file, located in the ..\FileNet\IDM installation directory.
  2. Replace the parameter(s) as shown in boldface in the example below, with the new value:
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.