jsbc
StreamBase Client — starts the StreamBase Client, Java implementation
DESCRIPTION
jsbc runs a Java implementation of the StreamBase client utility, which lets you send requests to a running StreamBase Server (sbd). For example, the jsbc list streams command requests the server to list available streams.
OPTIONS
With a few exceptions, the jsbc command has the same options as the sbc command, as described in sbc. The exceptions are:
- No space after -u or -p
-
For jsbc, there must be no space between
-u
and the following URI, and no space between-p
and the following port number:jsbc -usb://localhost:10000 listConnections jsbc -p9900 listConnections
Important
When communicating over an SSL connection, substitute
sbs:
forsb:
- -J option supported
-
The jsbc command accepts the
-J
option, but sbc does not.-J
jvm-option
-
Specifies a system property setting or other JVM argument to be passed to the JVM that runs this jsbc command. Use this option to specify temporary settings that affect only the current invocation of jsbc. You must specify multiple
-J
options to specify multiple JVM arguments.A space between the
-J
and its argument is optional. Use the full option syntax forjvm-option
that you would use at the Java command line, including the initial hyphen. For example, specify-J-Dstreambase.log-level=2
to increase the log level for this invocation of jsbc.Your
jvm-option
argument might require surrounding quotes, depending on the characters it contains and the shell you are using. However, do not use quotes to escape the spaces between separate JVM arguments; instead use separate-J
options. For example:-J-Xms512M -J-Xmx2G
To use jsbc to communicate over SSL connections, you need to configure access to the local trustStore for command-line Java utilities in this manner, substituting actual filenames and passwords (line breaks added for readability):
jsbc -J-Djavax.net.ssl.trustStore=C:/Temp/client.keystore -J-Djavax.net.ssl.trustStorePassword=cl123abc -J-Djavax.net.ssl.keyStore=C:/Temp/client.keystore -J-Djavax.net.ssl.keyStorePassword=cl123abc -usbs://localhost:10002;user=bob;password=secret deq OUT
For further details and instructions see SSL Authentication.
- Use sbs instead of sb in URI when running with a proxy server
-
For example, the following command connects to a proxy using Encrypted StreamBase Network Protocol over
sbs
:jsbc -u"sbs://proxyhost:port;user=theuser;password=123abc" enq InputStream
- No arguments for -h and --help
-
Unlike the sbc command, this jsbc command's
-h
and--help
options do not take subcommand arguments.
COMMANDS
The jsbc command accepts the same subcommands as the sbc command. However, note that sbc does not support Encrypted StreamBase Network Protocol. See sbc.
ENVIRONMENT
STREAMBASE_SERVER
-
Optional. Contains the URI for a StreamBase Server instance. Use this variable to set a default StreamBase URI for StreamBase commands that take the
-u
option. If set, commands use the URI in this variable, overriding their built-in default URI, which issb://localhost:10000.
If this variable is set, you must use the-u
option to communicate with any server other than the one specified in this variable. See the sburi page in the Reference Guide for more on StreamBase URIs. STREAMBASE_RETITLE_TERMINALS
-
Optional. If set to any value, StreamBase programs assign a terminal window title to match the name of the executable being run. By default terminal titles are not affected. Applies to jsbc dequeue and jsbc enqueue only.
STREAMBASE_LOG_LEVEL
-
Optional. Sets the minimum severity of messages that StreamBase writes to logging output. Default is 0, which gets NOTICE level messages and higher. Reasonable values are -1 (which disables NOTICE messages and shows only WARN, ERROR and FATAL messages), 1 (which adds INFO messages to the standard messages), and 2 (which adds DEBUG messages).