Enabled

ON - The application is Enabled by default when the service starts

OFF - The application must be enabled manually after the service starts

Home Folder

Working directory of the application. This is equivalent to the working directory of the isCOBOL Client

Icon

Image icon shown in the application selection dialog

Security Module Name

NONE - No authentication is required to access this application. The authentication may be required anyway to access webClient.

EMBEDDED - User authentication is required to access this application. Selecting this value will display a pop-up area with the list of current users, allowing you to edit them or to define new users.

PROPERTY_FILE - User authentication is required to access this application. The users must be defined in a property file. By default, the file user.properties under the webClient working directory is used.

DATABASE - User authentication is required to access this application. The users must be defined in a JDBC data source.

 

The rules to configure this field are the same described in Configuring Users except that they affect the single application instead of the whole webClient.

Security Module Class Path

Additional classpath for built-in Security module or for defining custom security module.

Use the '+' button to add a new entry.

Use the 'x' button to remove an entry.

Name

Name of the application.

isCOBOL Server address

IP address of the machine where isCOBOL Server is listening. webClient will connect to the isCOBOL Server in the same way as a isCOBOL Client. This is equivalent to the -hostname option of the isCOBOL Client

isCOBOL Server port

Port where isCOBOL Server is listening. webClient will connect to the isCOBOL Server in the same way as a isCOBOL Client. This is equivalent to the -port option of the isCOBOL Client

Program name and arguments

Name of the main program of the application optionally followed by one or more variables.

See How to pass command line arguments and end user info to the COBOL program for more details.

Username

User name for authenticating to the isCOBOL Server in case iscobol.as.authentication is set to "2" in isCOBOL Server’s configuration

Password

Password for authenticating to the isCOBOL Server in case iscobol.as.authentication is set to "2" in isCOBOL Server’s configuration

LAF

Look and feel to be used to display application’s windows

Remote configuration

Remote configuration file for the application. This is equivalent to the -c option of the isCOBOL Client

Local configuration

Local configuration file for the application. This is equivalent to the -lc option of the isCOBOL Client

Fonts

Customize logical font mappings and define physical fonts available to application. These fonts will be used for DirectDraw as native fonts.

Use the '+' button to add a new mapping.

Use the 'x' button to remove a mapping.

 

Every mapping is composed of two items: Key and Value.

Key is the name of the font.

Value is the path to the font file. Only True Type (ttf) fonts are supported.

 

If no fonts are defined, necessary fonts are loaded from the system by webClient as the COBOL application requests them. This rule applies to iscobol.font configuration settings as well as calls to the W$FONT routine. If some fonts are defined, these fonts will be the only fonts available for the COBOL application, so ensure to map all the necessary fonts otherwise some calls to W$FONT may fail and some iscobol.font configuration settings may be ignored. Configuring fonts is the only way to change the font used by window title bar and menu bar. For example, the following settings allow to obtain a better looking title bar and menu bar:

 

Name: "dialog", Value: "${user.dir}/fonts/Roboto-Regular.ttf"

Name: "dialoginput", Value: "${user.dir}/fonts/RobotoMono-Regular.ttf"

Name: "serif", Value: "${user.dir}/fonts/RobotoSlab-Regular.ttf"

DirectDraw Rendering

DirectDraw rendering mode uses canvas instructions to render the application instead of server-rendered png images. DirectDraw improves performance but is not recomended for applications with lot of graphics content.

Working Directory

Specifies the working directory of the isCOBOL Client on the machine where webClient is running.

Class Path

Local Classpath. The isCOBOL’s lib directory content must appear here. This is equivalent to the isCOBOL Client’s Classpath

JVM Arguments

Java options like -Xmx go here. You should use the same options that you would use to start the isCOBOL Client

Max. Connections

Limit the maximum number of concurrent sessions for this application. By default, up to 10 concurrent sessions are allowed

Session Mode

Define if and how sessions can be restored.

ALWAYS_NEW_SESSION - every time the application URL is loaded, a brand new runtime session is started.

CONTINUE_FOR_BROWSER - every time the application URL is loaded from the same browser, the user is offered the choice of starting a new runtime or restoring the previous one.

CONTINUE_FOR_USER - every time the application URL is loaded by the same user, the user is offered the choice of starting a new runtime or restoring the previous one. In this mode, the user can also restore the runtime session from different devices. This mode will have no effect if Security Module Name is not set to NONE, which would require users to perform authentication each time they open the application.

Session Timeout

Specifies how long will be the application left running after the user closes the browser. User can reconnect in this interval and continue in last session. The value is expressed in seconds.

Timeout if Inactive

ON - Session Timeout will apply for user inactivity.

OFF - Only disconnected sessions will time out.

Max Latency

This is used to control network resposiveness. It defaults to 500 milliseconds. When set to 0 it will disable latency checking, and the message "Your network connection is slow" will not appear .

Session Stealing

ON - If Session Mode is 'CONTINUE_FOR_USER', users can resume webclient session even if the connection is open in other browser. Former browser window will be disconnected.

OFF - Users can’t resume webclient session if the connection is open in other browser

Automatic Session Recording on viewing

ON - Session recording automatically starts when session is being viewed.

OFF - Session recording doesn’t automatically start when session is being viewed.

Automatic Session Recording on control

ON - Session recording automatically starts when session is being controlled.

OFF - Session recording doesn’t automatically start when session is being controlled.

Minimum display width in pixels for keyboard button

Specifies the minimum display width to allow the "keyboard" button to be shown.

A value of 0, the default, disable the function and will result in the Keyboard button to show on mobile devices whenever the user touches the screen. The size is not actually physical pixels. It depends on the pixel density of the display, and is reported by the browser (and hence the underlying OS). A display of 1980 pixels in width may be reported as 480 pixels or less, taking DPI settings in account.

Auto Logout

ON - Users are automatically logged out after the application finished.

OFF - Users remain logged in also after the application finished.

Isolated Filesystem

ON - the Open and Save dialogs of C$OPENSAVEBOX can only browse the webClient’s Upload Folder and its subfolders.

OFF - the Open and Save dialogs of C$OPENSAVEBOX can browse every folder of the machine where webClient is running.

Uploading Files

Enable the ability to upload files through the Open File dialog generated by the C$OPENSAVEBOX library routine.

Deleting Files

Enable the ability to delete files from the Open and Save dialogs generated by the C$OPENSAVEBOX library routine.

Downloading Files

Enable the ability to download files through the Save File dialog generated by the C$OPENSAVEBOX library routine.

Auto-Download from Save Dialog

Enable the automatic download of files to the end user’s PC when the Save File dialog of C$OPENSAVEBOX is called.

Upload Folder

Folder where files uploaded by the user through C$OPENSAVEBOX are stored.

Clear Upload Folder

ON - Delete all files in the transfer folder when the application process is terminated.

OFF - Don’t delete any file when the application process is terminated.

Upload Size Limit

Maximum size in MB of upload for single file. A valud of 0 means unlimited size.

Allow Local Clipboard

ON - Allow access to the end user PC local clipboard.

OFF - The user can’t cut, copy or paste text in the application screen.

Allow Server Printing

ON - Allow access to the printers installed on the machine where webClient is running.

OFF - Print to PDF using the internal WebPrintService printer and send the PDF to the client browser.

${webclient.appPath}

Context path of the application

${webclient.homeFolder}

Installation folder of webClient

${webclient.rootDir}

Root directory used to resolve relative paths

${webclient.server.host}

IP address of the server where webClient is running

${webclient.server.port}

Port where webClient is listening

${user}

webClient specific logged in user name

${clientId}

webClient specific unique browser identifier

${clientIp}

IP address of browser that started this application

${clientLocale}

Locale of browser that started this application

${customArgs}

Parameters specified via the "args" parameter in the URL.

 

The value of "args" matches the parameters that you would pass on the command line when running the isCOBOL Client from a command prompt. Multiple parameters must be separated by "%20" that matches the space you would use on the command line. For example, a URL like:

matches a command like:

Program name and arguments

PROG ${clientIp} ${customArgs}