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:
- On the server instance screen, select the 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 TN3270 To list service listeners for TN3270 clients (MSS only) MSS ISC To list service listeners for MSS Intersystem Communication - 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.