JDBC Driver Implementation and Configuration › Java Properties File › Properties Files › Proxy Options

Proxy Options

The JDBC Proxy options can be specified in the cadatacom.properties file and are prefixed with Proxy . Valid JDBC Proxy options are as follows:

• Backlog
• Host
• LogLevel
• LogTrace
• Port
• ReplyTimeOut
• Snap
• SocketTimeOut
• Trace
• WaitTimeOut

The Proxy option values are only valid for the CA Datacom Proxy. The following is an example of the cadatacom.properties file entries:

util.nojni=false (causes the values to be read from the registry)
Proxy.Port
Proxy.WaitTimeOut
Proxy.ReplyTimeout

Proxy.Backlog=<integer_value>

Specifies the maximum length of the listener queue. When this length is exceeded, new connections are refused. This is not the maximum number of client connections that can be supported.

Default: 50

Proxy.Host=<hostname>

(Optional) Specifies the DNS name or IP address the JDBC will bind to when it listens for client connection requests. This can be used to force the JDBC Proxy to listen for connection requests on a specific TCP/IP protocol stack on a multi-homed host (a machine with multiple TCP/IP stacks).

Default: Listen on all available stacks

Proxy.LogLevel=<integer_value>

Specifies the level of log messages sent to the system log or console. Valid options are as follows:

0 - Disable messages

4 - Error messages

6 - Warning messages

8 - Information messages, including start and stop events

10 - Verbose information messages, including client start and stop events

12 - Debugging messages, not including general trace output

Default: 8

Proxy.LogTrace=<integer_value>

Specifies the level of log messages sent to the trace file. Options are identical to options for LogLevel.

Default: 8

Proxy.Port=CA Portal

Specifies the IP listener port for the JDBC Proxy.

Default: 3709

Proxy.ReplyTimeOut=<integer_value>

Specifies the number of seconds that the JDBC Proxy waits for a response from the CA Datacom system. The default causes the JDBC Proxy to wait indefinitely.

Default: 0

Proxy.Snap=true|false

Enables display of data buffers, sent and received, in the log file. The log file is specified in the Trace.File property

Proxy.SocketTimeOut=<integer_value>

Specifies the number of seconds the JDBC Proxy waits, or blocks, when reading data from a socket. While a socket is being read, the thread is blocked, and is not able to recognize an event that stops the thread. When this interval expires, the thread checks if the JDBC Proxy is still running and if it is, issues another read on the socket continuing until the wait or reply timeout has expired. A high value reduces JDBC Proxy overhead, while a low value allows the server to respond to shutdown events more quickly. Setting this to 0 causes the thread to block forever and is not recommended.

Default: 60 seconds

Proxy.Trace=true|false

Enables tracing of internal function calls. Output is written to the log file specified in the Trace.File property.

Default: false

Proxy.WaitTimeOut=<integer_value>

Specifies the number of seconds that the JDBC Proxy waits for a request from the JDBC driver before assuming the connection has been terminated. The default causes the JDBC server to wait indefinitely.

Default: 0