Configuration File Information › Configuration Information › Sections › Proxy

Proxy

The [Proxy] section contains information used to configure the JDBC server. It can contain the following parameters:

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. The default is 50.

ClientAuth=0|1

Requires a client certificate when JDBC driver clients connect to this proxy server using SSL.

Encoding=character_encoding_name

Specifies the character encoding that the JDBC server requests the JDBC driver to use when sending and receiving character data. If not specified, the default encoding for the JVM is requested. The character encoding class must be accessible to the JDBC driver when invoked by the client application or applet.

In Java, all character data is represented internally as Unicode. Ultimately this data must be converted to the native platform encoding used by CA IDMS, a variant of EBCDIC specified by the code page. The Java platform includes classes to convert between Unicode and the various character encodings. The encodings supported by a particular Java implementation depend on the vendor.

In the absence of documentation, it might be possible to determine the encodings supported by converted classes supplied with the Java implementation. These are generally named ByteToCharxxxxx.class and CharToBytexxxxxx.class, where xxxxxx is the encoding name. A minimal subset of the converter classes is installed in the base library for the Java Run Time Environment, jre/lib/rt.jar. Additional converter classes are included with the international version of the Java 2 Platform, installed in the same subdirectory, but the actual filenames vary by release. For Java 1.4 the international converter classes are in charsets.jar.

Host=host_name

Specifies the DNS name or IP address the JDBC binds to when it listens for client connection requests. This can be used to force the JDBC server to listen for connection requests on a specific TCP/IP protocol stack on a multi-homed host (a machine with multiple TCP/IP stacks). The default is to listen on all available stacks.

LogLevel=integer_value

Specifies the level of messages sent to the system log or console. Choose one of the following options:

• 0—Disable messages
• 4—Error messages
• 6—Warning messages
• 8—Information messages, including start and stop events. This is the default.
• 10—Verbose information messages, including client start and stop events
• 12—Debugging messages, not including general trace output.

LogTrace=integer_value

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

Port=port

Specifies the IP port that the JDBC server listens on for connection requests. The default is 3709.

RemoteControl=0|1

Enables a remote client to control the JDBC server; to SUSPEND, RESUME, or STOP it. The default value, 0, allows remote clients only to check the STATUS of the JDBC server.

RemoteHost=host_name

(Optional) Specifies the DNS name or IP address of a CA IDMS system (r16 SP2 or later), or another JDBC server used to forward packets to the CA IDMS system.

RemotePort=port

Specifies the IP port address of the remote host. The default value is 3709.

RemoteSSL=0|1

Enables SSL when communicating with another proxy server.

ReplyTimeOut=integer_value

Specifies the number of seconds that the JDBC server waits for a response from the CA IDMS system. The default, 0, causes the JDBC server to wait indefinitely.

SSL=0|1

Enables Secure Socket Layer (SSL) connections between this proxy server and a JDBC driver client.

Snap=0|1

Enables display of data buffers, sent and received, in the log file.

SocketTimeOut=integer_value

Specifies the number of seconds the JDBC server 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 server is still running, and, if so, issues another read on the socket, continuing until the wait or reply timeout has expired. A high value reduces JDBC server 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. The default is 60 seconds.

Trace=0|1

Enables tracing of internal function calls. Output is written to the log file.

Unicode=0|1

Enables the use of Unicode as the character encoding when the JDBC driver is unable to use the requested encoding. The default value, 0, specifies the use of UTF-8, which is supported by all Java platforms.

WaitTimeOut=integer_value

Specifies the number of seconds that the JDBC server waits for a request from the JDBC driver before assuming the connection has been terminated. The default, 0, causes the JDBC server to wait indefinitely. It is usually best to set a timeout value to drop the connection when the client has been inactive for some reasonable time interval. For example, set this value to 1800 to specify a timeout of 30 minutes.