Installing and Setting Servlet Arguments

jConnect installation includes a gateway2 subdirectory under the classes directory. The subdirectory contains files required for the TDS-tunnelling servlet.

  1. Copy the jConnect gateway package to a gateway2 subdirectory under the servlets directory of your Web server.

    After you have copied the servlets, activate the servlets by following the instructions for your Web server.

  2. Add the servlet to theWeb server and, to customize performance set the optional arguments:
    • SkipDoneProc [true|false] – Sybase databases often return row count information while intermediate processing steps are performed during the execution of a query. Usually, client applications ignore this data. If you set SkipDoneProc to true, the servlet removes this extra information from responses, which reduces network usage and processing requirements on the client. This is particularly useful when using HTTPS/SSL, because the unwanted data is not encrypted/decrypted.

    • TdsResponseSize – set the maximum TDS packet size for the tunneled HTTPS. A larger TdsResponseSize is more efficient if you have only a few users with a large volume of data. Use a smaller TdsResponseSize if you have many users making smaller transactions.

    • TdsSessionIdleTimeout – define the amount of time, in milliseconds that the server connection can remain idle before the connection is automatically closed. The default TdsSessionIdleTimeout is 600,000 (10 minutes).

      If you have interactive client programs that may be idle for long periods of time and you do not want the connections broken, increase the TdsSessionIdleTimeout.

      You can also set the connection timeout value from the jConnect client using the SESSION_TIMEOUT connection property. This is useful if you have specific applications that may be idle for longer periods. In this case, set a longer timeout for those connections with the SESSION_TIMEOUT connection property, rather than setting it for the servlet.

    • Debug – turn on debugging.