Edit Listener

Apply Certificate Configuration Information Connection Endpoint Current Status Delete Description Handlers Keyfile Legacy Micro Focus Application Format | Listeners Name New Status Packages Secure Sockets Layer Servers Services Supported Conversation Type

Edit Listener

  Use this page to change configurable attributes of a listener.

  Top

Servers

  Click this to return to the list of all the servers on this Directory Server, on the Home page.

  Top

Listeners

  Click this to view a list of all the service listeners registered with the current server.

  Top

Services

  Click this to view a list of all the services registered with the current server.

  Top

Handlers

  Click this to view a list of all the request handlers registered with the current server.

  Top

Packages

  Click this to view a list of all the packages registered with the current server.

  Top

Name

  Specify the unique name of the listener, up to 255 characters in length. You cannot include angle brackets (<>) or ampersands (&) in the name.

  Top

Connection Endpoint

  Specify 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.

  If this network address is not unique in the repository, this may cause listener start-up problems.

  Top

Secure Sockets Layer

  Check this to enable Secure Sockets Layer (SSL), which provides encrypted communication between server and client applications and authentication of online entities.

  Top

Certificate

  Enter the filename of your server certificate, such as srvcert.pem. If this file is not in the default directory (which is the certs directory at the location defined by the SSLDIR environment variable), you also need to specify the full path to the file. The server certificate proves your identity to people you communicate with online and enables them to send you data in encrypted form.

  Top

Keyfile

  Enter the filename of your private key file, such as srvkey.pem. If this file is not in the default directory (which is the keys directory at the location defined by the SSLDIR environment variable), you also need to specify the full path to the file. You use the private key to decrypt encrypted data you receive.

  Top

Legacy Micro Focus Application Format

  Check this if you want the listener to handle non-standard TCP/IP flows, for example, for Fileshare clients.

  Top

Current Status

  Shows the current status of the listener:

  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.

  Top

New Status

  Choose a status from the list. If the status of the server is "Started", the possible listener statuses are:

  Blocked | The listener is still running but will not be found by clients searching for this listener in a "Started" state. One use for this status is where you want to allow requests from only one client, perhaps for debugging purposes. You could amend the client code to ignore a "Blocked" status and allow requests through.
  Disabled | The listener is stopped and will not be started.
  Started | The server listener is started.
  Stopped | The listener is stopped.

  If the status of the server is "Stopped", the possible statuses are:

  Blocked | The listener is stopped. The listener is started when the server starts, but will not be found by clients searching for this listener in a "Started" state. One use for this status is where you want to allow requests from only one client, perhaps for debugging purposes. You could amend the client code to ignore a "Blocked" status and allow requests through.
  Disabled | The listener is stopped and it will not be started when the server starts.
  Stopped | The listener is stopped. It will be started when the server starts.

  Top

Supported Conversation Type

  Shows the conversation type of the listener.

  - MFES Requests for client requests that use a conversation protocol supported by the request handlers provided by Micro Focus, MFRHBINP and MFRHSOAP.
  - Custom for other kinds of client requests. Specify the name of the connector module in the entry field next to Custom.

  Top

Configuration Information

  Specify textual configuration information that determines the start-up and run-time behavior of the listener. Optional.

  Top

Description

  Specify a text description of the listener, for example, its purpose and owner. Optional.

  Top

Apply

  Click this to apply your changes to the listener.

  Top

Delete

  Click this to delete the listener. You cannot delete a listener if it is registered for use with a service.

  Top