Enterprise Manager Java App: Web Configuration

In BBj 9.0 and higher, the Enterprise Manager introduces Web Configuration with three tabs; Webserver for general configuration, Applications for Web Start configuration, Web Services for creating and configuring Web Services.

Webserver

Description

The Webserver tab configures general BBj Webserver settings that apply to the Web features.

Start Webserver

Turns on the built-in Webserver.

Log File

Full path of the log file where all Webserver logs will appear.

Host Name

The name of the computer on which BBj is installed.

Port

The port name.

Keystore

Full path to the keystore used for signing jars. Applications deployed via Java Web Start must be digitally signed. BBj automatically signs the jars with an example keystore provided with the installation. To use a different keystore, provide it here.

Keystore Password

Password To sign jars automatically, BBj requires the keystore password.

Private Key

Each keystore may have multiple keys, specify the name of the key you wish to use.

Run Enterprise Manager

Enterprise Manager is configured to run automatically via Web Start; disable running of Enterprise Manager here.

Enterprise Manager Link

The URL for accessing Enterprise Manager.

Applications

Description

The Applications tab shows all applications currently configured to run in BBj. Additionally, this tab provides management tools for configuring BBj applications to run in the Web Start environment.


Application List

A list of all applications configured to run in Java Web start.

New

Create a new configuration, to run an application under Java Web start.

Edit

Modify an existing configuration. See the section "Edit" below.

Delete

Remove an unwanted configuratiocxn.


Edit

Edit the configuration details of BBj applications running in Webstart
.

Name

Name of the application URL.

Title

Title of the application displayed to the user at launch time.

Vendor

Title of the vendor displayed to the user at launch time.

Short Description

Description displayed to the user on the launch splash screen.

User

User specified by the -u flag; may be left blank for default Web user.

Config File

The configuration file to use, normally specified by the -c option.

Program

The BBj program to run.

Link

The URL where BBj will publish your application.

Jars

List of additional jars to be included in the jnlp file.

Arguments

Additional arguments to the program.

Web Services

Description

Displays a list of the Web Services currently configured that publish automatically when BBj starts.

Web Services list

The list of available services.

New Service

Create a new Web service.

Edit Service

Add and remove methods from existing services.

Delete Service

Remove an unwanted service.

Publish Service

The configuration file to use, normally specified by the -c option.


Edit Service

Add and remove methods of a Web service. Each method call will start a new BBj Interpreter and call the program you specify. Various configuration options may be passed to that interpreter.

Name

Name of the service.

Working directory

Specifies the working directory for the interpreter that executes the program.

Config file

Path to the config file for the interpreter that executes the programs.

New Method

Add a new method to the Web service.

Edit Method

Changes the details of the existing method.

Delete Method

Deletes the method.

Ok

Returns to the Web Services overview screen.


Edit Method

Web Services calls map to a CALL with ENTER of a BBj program. The Webserver and interpreter need specific details the enter statement to call the implementing function correctly.

Name

Name of the method published to the world.

Call

The source file and label to call when a request is handled.

Return Index

Index of the argument to return; zero based.

Argument List

A list of all argument types that will be passed to the ENTER.

BBjString

Add a string argument.

BBjNumber

Add a numeric argument.

BBjInt

Add an integer argument.

(text box)

Allows the entry of a Java type.

Custom

Adds the type specified in the textbox.

Ok

Return to the Web Service editing screen.


Your Web Service will be available in the built-in jetty server after publishing. The host name, port number, and Web Service name combine to produce a wsdl file available at this address http:// <hostname>:<port>/webservice/<web service name>?wsdl. For example, a Web Service named example deployed on a host named myserver would be available at this url: http://myserver:8888/webservice/example?wsdl.