JDBC Driver Implementation and Configuration › JDBC Proxy Service Wrapper

JDBC Proxy Service Wrapper

The JDBC Proxy service wrapper controls the JDBC Proxy with batch jobs or shell commands.

• BPXBATCH is used to run the corresponding shell scripts.
• Shell commands are also used to control the JDBC Proxy. The following format is valid when using shell commands:

  cadcjsrv <command> [<cadcjsrv options>] [-jvm] [<java options>]
  

These commands invoke a shell script that sets the required environment variables and runs the JDBC Proxy service wrapper. The service wrapper starts the JVM and passes control to the JDBC Proxy entry point. You can also enter the commands in the following form: cadcjsrv.start, cadcjsrv.stop, and so on.

• You can override the run-time options from the configuration file by specifying them on the command line.
• All options that follow -jvm are passed unchanged to the JVM to allow specification of Java tuning and debugging options.

When started in normal mode, the JDBC Proxy forks a new process and detaches from the terminal. All tracing and debugging is written to the log file specified in the configuration file. When started in debug mode, the JDBC Proxy runs in the foreground and stays attached to the terminal. Pressing Enter shuts down the JDBC Proxy. Tracing output can be displayed on the terminal, redirected to the standard output, or written to the trace file. Messages to the system log can also be echoed on the standard output.

The following commands are used to control the JDBC Proxy:

cadcjsrv start

Starts the JDBC Proxy as a background process.

cadcjsrv stop

Stops the JDBC Proxy.

cadcjsrv suspend

Suspends the JDBC Proxy.

cadcjsrv resume

Resumes the JDBC Proxy.

cadcjsrv status

Checks the JDBC Proxy status.

cadcjsrv debug

Starts the JDBC Proxy as a foreground process.

cadcjsrv usage

Displays the server usage.

In addition to the commands, you can also code the options by entering them individually or through the properties file. Valid options are as follows:

-?

Specifies to print this information.

-b <seconds>

Specifies the socket blocking timeout interval.

-d <option> [<option>]...

Debugs trace options. Valid trace options are as follows:

buffer

Enables the native buffer display.

native

Enables the native trace.

object

Enables the native object display.

snap

Enables the object display.

trace

Enables the debug tracing.

stub

Enables the stub client.

util

Sends the trace to the utility log.

-h <addr>

Specifies the host listener address or name.

-i <class> [<class>]...

Includes the <class> in trace.

-l <level>

Specifies the set trace log message level.

-p CA Portal

Specifies the host listener port.

-q <count>

Specifies the host listener queue length.

-t <seconds>

Specifies the server reply timeout interval.

-v [<level>]

Specifies the set syslog message level defaults to "verbose" if no level.

-w <seconds>

Specifies the client wait timeout interval.

-x <class> [<class>]...

Excludes the <class> from trace.

More information:

Proxy Options

Server and the z/OS Environment