javaws

You use the javaws tool command and its options to start Java Web Start.

Synopsis

javaws [run-options] jnlp

javaws [control-options]

run-options

The run-options can be in any order. See Run-Options for the javaws Command.

jnlp

This represents either the path of or the URL of the Java Network Launching Protocol (JNLP) file.

control-options

The control-options can be in any order. See Control-Options for the javaws Command.

Description

Note:

The javaws command isn’t available on Oracle Solaris.

The javaws command starts Java Web Start, which is the reference implementation of the JNLP file. Java Web Start starts Java applications and applets hosted on a network.

If a JNLP file is specified, then the javaws command starts the Java application or applet specified in the JNLP file.

The javaws command has a set of options that are supported in the current release. However, the options may be removed in a future release.

See Java Platform, Standard Edition Deployment Guide for information about the user and system cache and deployment.properties files.

Run-Options for the javaws Command

-verbose

Displays additional output.

-offline

Runs the application in offline mode.

-system

Runs the application from the system cache only.

-Xnosplash

Runs without displaying a splash screen.

-Joption

Passes the option to the Java Virtual Machine (JVM), where option is one of the options described on the reference page for the Java application launcher. For example, -J-Xms48m sets the startup memory to 48 MB. See java.

-wait

Starts the java process and waits for its exit. The javaws tool process does not exit until the application exits. This option doesn’t function as described on Windows platforms.

-open arguments

Replaces the arguments in the JNLP file with -open arguments .

—print arguments

Replaces the arguments in the JNLP file with -print arguments .

Control-Options for the javaws Command

-viewer

Shows the cache viewer in the Java Control Panel.

-userConfig property-name

Clears the specified deployment property.

-userConfig property-name property-value

Sets the specified deployment property to the specified value.

-clearcache

Removes all noninstalled applications from the cache.

-uninstall

Removes all applications from the cache.

-uninstall jnlp file

Removes the application from the cache.

-import import-options jnlp-file

Imports the application to the cache. See Import-Options for the javaws Command for the list and description of available options.

Import-Options for the javaws Command

-silent

Imports silently without the user interface.

-system

Imports the application to the system cache.

-codebase url

Retrieves resources from the specified codebase.

-shortcut

Installs shortcuts if the user allows a prompt. This option has no effect unless the -silent option is also used.

-association

Installs associations if the user allows a prompt. This option has no effect unless the -silent option is also used.

Note:

The command, javaws -shortcut -uninstall, removes both the association as well as the implementation.