Listeners

Use this page to view a list of the communications processes and service listeners registered for the currently selected server. From this page you can also:

• Make some specific edits to a communications process
• Create a communications process by copying an existing one
• Delete a communications process
• Edit the configurable settings of a listener
• Add a new listener

To access this page:

1. On the server instance screen, select the Listeners tab.

Listener Display Filters

Use this group of fields to apply filters to the list of listeners so that you can just view a subset.

Note:

It is possible to specify filters such that no information is displayed.

Process

Choose an option for filtering by communications process:

All	To list all service listeners regardless of communications process
None	To list no service listeners
n	To list just the service listeners that belong to communications process n

Conversation Type (filter)

Choose an option for filtering by conversation type:

All	To list all service listeners regardless of conversation type
Custom	To list service listeners with a custom conversation type
Web Services and J2EE	To list Web Services and J2EE service listeners
Web	To list Web service listeners
Fileshare	To list Fileshare service listeners

Status

Choose an option for filtering by status:

All

To list all service listeners regardless of status

status-type

To list service listeners with the status status-type, where status-type can be one of: Started Stopped Disabled Blocked Not Responding; this means any listener whose status is unknown because the server it is registered with is not responding to the server monitor Not Started; this means any listener with a status other than Started Not Stopped; this means any listener with a status other than Stopped

Auto-start

Check this to indicate that this communications process is started automatically when the enterprise server starts.

Statistics

Click this to see detailed information about the listener activity on this enterprise server. The information is shown in a new window. You can click this only if the enterprise server is started.

Change

Changes into Stop or Start when the enterprise server is started.

Stop

Click this to stop the communications process and all its listeners. You can click this only if the enterprise server is started, the communications process is started, and this communications process is not Communications Process 1.

Start

Click this to start the communications process and all its listeners. You can click this only if the enterprise server is started, the communications process is not started, and this communications process is not Communications Process 1.

Copy

Click this to create a new communications process by copying this one.

Delete

Click this to delete this communications process. If a server only has one communications process you cannot delete it.

Edit (communications process)

Click this to edit configurable settings for this communications process.

Listeners

Shows the number of listeners owned by this communications process.

Add

Click this to add a new listener.

Process ID

Shows the process ID of this communications process.

Control Channel Address

Shows the internal address used by the communications process for communicating with other components of the enterprise server. The format is:

protocol:ip-address:port

where:

• protocol is tcp.
• ip-address is either the text host name or IP address of the communications process. An asterisk (*) indicates that the address is dynamically assigned for the communications process when it starts.
• port is the port value. An asterisk (*) indicates that the port is dynamically assigned for the communications process when it starts.

Under the network address is the DNS-resolved TCP/IP hostname.

Status (communications process)

Shows the current status of the communications process. The possible statuses are:

Not responding	The communications process status is unknown because the server it is registered with is not responding to the server monitor.
Started	The communications process is running.
Stopped	The communications process is stopped.

Last Status Change (communications process)

Shows the time that the communications process's current status was last updated; this time is local to the machine where the Directory Server is running.

Status Log (communications process)

Shows information about the most recent event that occurred on this communications process.

Version

Shows the version string of the communications process. This consists of three elements in decreasing order of significance: major version, minor version, build version. This can be used to distinguish between communications processes of the same name.

Edit (listener)

Click this to edit configurable settings for this listener.

Name

Shows the name of the service listener.

Address

Shows the network address used by the listener to accept incoming client requests. The format is:

protocol:ip-address:port

where:

• protocol is tcp.
• ip-address is either the text host name or IP address of the server listener. An asterisk (*) indicates that the address is dynamically assigned for the listener when it starts.
• port is the port value. An asterisk (*) indicates that the port is dynamically assigned for the listener when it starts.

Under the network address is the DNS-resolved TCP/IP hostname.

Status (listener)

Shows the current status of the service listener. The possible statuses are:

Blocked	The listener is started when the server starts, but it does not accept client requests.
Disabled	The listener is stopped and is therefore not available to any client
Invalid	An error has occurred such that it has not been possible to set the status to any other value
Not responding	The listener status is unknown because the server it is registered with is not responding to the server monitor
Started	The server listener is running.
Stopped	The listener is stopped.
Start Pending	The SSL-enabled communications process is waiting for you to enter a password to give access to its private key. Less commonly, a password may also be required to give access to its certificate. To do this, click Authorize. On the page that appears in a second browser, enter the password (leave the certificate password blank unless it's required) and click Set Passphrases. Then close that browser.

Last Status Change (listener)

Shows the time that the listener's current status was last updated; this time is local to the machine where the Directory Server is running.

Status Log (listener)

Shows information about the most recent event that occurred on this listener.

Conversation Type

Shows the conversation type of the listener.

Custom Configuration Data

Shows optional textual configuration information that determines the start-up and run-time behavior of the listener. For details of the entries, see the section Configuration Information in the chapter Communications Processes and Service Listeners in your Configuration and Administration Guide.

Description

Shows an optional text description of the listener, for example, its purpose and owner.