Easysoft JDBC-ODBC Bridge Web Administrator

Version &job_version;

Statistics
Configuration
Demo
Security
Information

Data Access by Easysoft

&job_table;

Help

Port

The port on which the Easysoft JDBC-ODBC Bridge server listens for incoming client connections.

HTTPPort

The port on which the Easysoft JDBC-ODBC Bridge Server listens for HTTP requests. The default is port 8031 but it may be any port not already in use. If HTTP Server is set the Easysoft JDBC-ODBC Bridge Server listens on the specified port for HTTP requests in addition to acting in its normal role serving the Easysoft JDBC-ODBC Bridge Client. You may use the URL http://machine_name:HTTPPort where machine_name is the name (or IP address) of the machine running the Easysoft JDBC-ODBC Bridge Server and HTTPPort is the port number to communicate with the Easysoft JDBC-ODBC Bridge Server from your browser. It can show statistics, DSNs and the current values of configurable parameters.

Timeout

The inactivity timeout in seconds (the default is 7200 - 2 hours). The Easysoft JDBC-ODBC Bridge server starts a new thread (or process) for each client that connects. If there has been no communication in timeout seconds the thread/process exits. This ensures clients which fail to close down properly do not cause increasing resource usage on the server.

MaxThreadCount

The maximum number of threads or processes the Easysoft JDBC-ODBC Bridge Server will allow at any time. One thread/process is created for every ODBC connection. If MaxThreadCount is set to 0, there is no limit. The default is 100. You can use this parameter to prevent too many simultaneous connections swamping your server.

RetryCount

The number of times the server will attempt to create a thread/process to handle a connection or the number of times the server will attempt to obtain a license slot for a new connection.

RetryPause

The time in seconds between each retry attempt (see RetryCount above).

SingleStatement

By default, Easysoft JDBC-ODBC Bridge will attempt to pool statement handles in the ODBC driver, and open new connections behind the scenes to support multiple concurrent statements even if the backend ODBC driver does not. If you know that you do not need this feature, i.e. You ensure that there is only a single result set open at any one time, set this to 'Y'.

HTTPAdmin

This is the username of the person allowed to make changes to the Easysoft JDBC-ODBC Bridge server via the HTTP interface. This must be a valid username in the operating system the server is running on. If set to the string "disabled" (omit the quotes) then HTTP authentication is not required (this does not mean the Easysoft JDBC-ODBC Bridge Server stops authenticating incoming ODBC connections).

Path

This is the installation path of the Easysoft JDBC-ODBC Bridge. This cannot be changed via the browser interface.

Logging

A bitmask to specify which type of event the Easysoft JDBC-ODBC Bridge Server should log in the log file. This should only be used as directed by Easysoft support and will slow the Easysoft JDBC-ODBC Bridge down considerably if set. You may specify the number as decimal or hexadecimal (e.g. 2047 or 0x7ff).

LogDir

Specifies the directory where log and audit files are created (see Logging and AuditODBCAccess). Since version 1.5, the default directory in Windows is <drive>:\Program Files\Easysoft\Easysoft JDBC-ODBC Bridge\Logs (the previous default was <drive>:\temp). In UNIX, the default is /tmp. In Windows, this is also the directory where the Easysoft JDBC-ODBC Bridge Server will create an esjob.exception file if an unhandled exception is caught.

Flags

This is a bitmask of operational flags. The bitmasks are split into check boxes, one for each bit in Flags.

  1. Authentication_Disabled (0x1) Disables authentication in the Easysoft JDBC-ODBC Bridge ODBC Server. Setting this parameter should be considered as a security risk. However, on some high hit servers in a controlled environment where you do not need to authenticate the connections this can save a considerable amount of time during connections. e.g. in NT 0.25 to 0.75 seconds of the connection time can be spent in authentication. The default is clear, i.e. not set).
  2. HTTP_Server (0x2) Start listening for HTTP connections when the server starts (default is set)
  3. MultiProcess (0x4) The Easysoft JDBC-ODBC Bridge Server starts a new process for each incoming connection instead of a new thread (default is clear, i.e. not set and therefore the Server starts a new thread per connection). Should be set if the ODBC driver is not thread-safe or leaks memory. Currently on non-Windows platforms the server always starts new processes as it is not multi-threaded and so this flag cannot be changed. This flag is ignored in Windows 9x.
  4. Reserved (0x8)
  5. HideSensitive (0x10) Causes the HTTPAdmin and Authentication_Disabled parameters not to be shown on the HTTP Server main configuration information page when turned on. All parameters are always shown in full on the change configurable parameters page as this page is password protected. The default is on.
  6. ReverseLookup (0x20) If set causes the Easysoft JDBC-ODBC Bridge Server to call gethostbyaddr() on the connecting client's IP address to obtain the client's machine name. On machines where DNS is not set up properly this can cause problems and in any case adds time to the connection. ReverseLookup currently only affects the statistics, number of different clients page where "unknown" will be displayed instead of the machine name for connecting client's machine names if ReverseLookup is off. The default is off.
  7. AuditODBCAccess (0x40) If set causes the Easysoft JDBC-ODBC Bridge Server to audit all ODBC connections to a log file which may be viewed through the HTTP interface. The audit file is written to the LogDir directory as esjob_access.log. The default is off.
  8. Reserved (0x80)
  9. ShowProcessTime (0x100) If set the Easysoft JDBC-ODBC Bridge Server retrieves the user and kernel CPU times for the main Easysoft JDBC-ODBC Bridge Server process and displays them on the statistics web page. The values are only updated once every 5 seconds. The default is on.