Oracle Forms Services
Standalone Application Launcher

Overview:

The Oracle Forms Standalone Application Launcher (FSAL) offers an alternative way for end-users to run Oracle Forms applications. FSAL offers a browser-less, more client/server-like interface. As a result of not using a browser, FSAL does not use the Java Plugin component of a Java Runtime Environment (JRE) or Java Developer Kit (JDK). All that is required to run FSAL on the end-user machine is a supported Java installation. This can be either the JDK, the JRE, or Server JRE. To determine which Java versions are supported, please contact your administrator.

How To Use:

1. Download the FSAL from here:
2. Open a shell (e.g. cmd on Windows) and change directories to where the above file was saved.
3. Enter the following to run your application. The URL value should be provided by your Administrator.

   java -jar frmsal.jar -url "<URL>" -t <time in milliseconds> -showConfig <boolean> -showDetails <integer> -changeFSALStorePass <boolean> -autoImportCert <boolean>

   Example:

   java -jar frmsal.jar -url "http://myFormsServer:8888/forms/frmservlet?config=standaloneapp" -t 30000 -showConfig true -showDetails 1

Additional Usage:

java <options> -jar frmsal.jar -url "<Oracle Forms URL with config name>" -t <time in milliseconds for timeout> -showConfig <boolean> -showDetails <integer>

-url URL (required)

The URL should represent the fully qualified address to the Forms environment, to include the configuration name. If config is not included, the default will attempt to load.  The URL should be quoted.

Note: In the scenario where -changeFSALStorePass is used, -url is not required.

-t time (optional - default value 60000ms)

The time is the amount of time the launcher should wait for the server to provide its initial response before timing out. The value should be entered in milliseconds and be whole numbers only.

-showConfig boolean (optional - default value false)

Should the config parameters received from the server be displayed in the console.

-showDetails integer (optional - default value 0)

Should additional debug information be displayed.

0 indicates no additional information should be displayed.

1 shows details about location from where resources are loaded.

2 shows details about SSL/TLS related information when certificate information is not in the FSAL TrustStore.

99 shows all the details.

Other values are reserved for future use.

-changeFSALStorePass boolean (optional - default value false)

This option is used to change the password of the FSAL custom TrustStore. If this option is provided, -url is not required. This option only applies when used in conjunction with -cert_truststore forms (or unset).

-autoImportCert boolean (optional - default value false)

Should the SSL/TLS certificates be imported without any user interaction. This option only applies when used in conjunction with -cert_truststore forms (or unset).

-cert_truststore string (optional - default value forms)

This option is used to identify which Java TrustStore should be used to store SSL/TLS certificates. A value of "forms" or unset will result in using a Forms generated Java TrustStore. A value of "java" will cause FSAL to look in the default Java TrustStore for storing and verifying SSL/TLS certificates. When using the Java default TrustStore, you must manually import needed certificates into it before running any SSL/TLS application.

Java options for configuring proxy settings:

HTTP Proxy

Example:  java -Dhttp.proxyHost=<proxy-host> -Dhttp.proxyPort=<proxy-port> -jar frmsal.jar -url "<URL>"

HTTPS Proxy

Example:  java -Dhttps.proxyHost=<proxy-host> -Dhttps.proxyPort=<proxy-port> -jar frmsal.jar -url "<URL>"

Exceptions

Example:  java -Dhttp.nonProxyHosts=”localhost|example.com” -Dhttps.proxyHost=<proxy-host> -Dhttps.proxyPort=<proxy-port> -jar frmsal.jar -url "<URL>"

Use System Settings (this may not be compatible with some automatic proxy configuration scripts)

Example:  java -Djava.net.useSystemProxies="true" -jar frmsal.jar -url "<URL>"

 

Refer to the Java documentation for more information on using proxy settings.