Listener Control

Use this page to view and control ES for .NET listener processes.

A given ES for .NET listener process is displayed on this page when it has registered itself with one or more of the database instances configured on the page. A listener will register itself with a database instance the first time it successfully connects to a region that uses that database instance.

To add or remove database instances for the page:

  1. Click DATABASE INSTANCES.

    This opens the Database Instances dialog box.

  2. Type the name of the database instance to use.
  3. Click OK.

Instances will appear in the navigation tree on the Listener Control page. Under each instance a list of known Listener Processes will appear when that instance is expanded.

Selecting a listener process will display its URL, host, and process ID. Expanding it will display the regions for which the listener has channels.

To temporarily add a region to a listener process:

  1. Click + ADD REGION.

    This opens the ADD REGION dialog box.

  2. In the Name field, type the name of the region.
  3. In the Database Server field, type database server instance where you want your region database to be created.
  4. Click OK.
Note: To permanently add a region to a listener, edit the listener's configuration file, using the ES for .NET MMC snap-in or by editing the seelistener.exe.config file in a text editor.

Expanding a region under a listener process will display the current channels.

To temporarily add a channel:

  1. Click + ADD CHANNEL.

    This opens the Add Channel dialog box.

  2. In the Name field, type the name of the channel.
  3. In the Protocol field, click the required protocol.
  4. In the Port field, type the port number the channel will listen on.
  5. Alternatively, expand the ADVANCED properties and specify as required.
  6. Click OK.
Note: To permanently add a channel to a region, edit the listener's configuration file.

Selecting a channel will display its properties. You can also edit, disable, enable, or delete the channel.

Channel Properties

Name
The name of the channel.
Protocol
The protocol the channel uses:
  • TN3270
  • MFBINP
  • HTTP
  • MQ
  • P2P
Port
The port the channel will listen on.

Advanced Channel Properties

Enabled
Click this to enable the channel.
Heartbeat
Heartbeat (keepalive) time in seconds.
Idle Conversation Timeout
Timeout for idle persistent HTTP conversations.
Cookie Timeout
Timeout specified for HTTP session cookies.
Idle Session Timeout
Timeout for idle persistent HTTP sessions.
IP Version
The version of the IP protocol to use:
  • IPv4
  • IPv6
  • Both
Cookie Path
Path specified for HTTP session cookies.
Data Trace
File path or URL for data-trace output.
Send 100 Continue
Whether the listener should respond to 100-Continue requests from HTTP clients.