Change the application configuration
Select the desired application from the list on the left to access the list of available configuration entries.
Entry
Meaning
Enabled
ON - The application is Enabled by default when the service starts.
OFF - The application must be enabled manually after the service starts.
Context Path
Url context path where the application will be deployed
Name
WebClient application name. This name will be displayed on the left panel and used to alphabetize the list of WebClient applicaitons.
Web Home Folder
Home directory for web related content. This is the base directory for every relative classpath entry.
Web Folder
Folder to be used to store customized static web files like HTML, CSS or JavaScript
Restricted Resources
List of paths that will be accessible only by authenticated users
Localization Folder
Folder where customized messages and translations are stored.
Icon
Image icon shown in the application selection dialog
CORS Origins
List of domains for which cross-origin resource sharing is allowed. This is useful if you’re embedding the application in a page that resides on a different domain
Upload Size Limit
Maximum size in MB for uploaded files. A value of 0 means no limit
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.
Monitor App Responsiveness
ON - Show a progress animation if Swing’s Event Dispatch thread is not responding
OFF - Don’t advise users if Swing’s Event Dispatch thread is not responding
Loading Animation delay
Delay in seconds before showing the progress animation. This setting is considered when Monitor App Responsiveness is ON. The minimum value is 2.
Session Stealing
ON - If Session Mode is 'CONTINUE_FOR_USER', users can resume the WebClient session even if the connection is open in other browser. Former browser window will be disconnected.
OFF - Users can’t resume the WebClient session if the connection is open in other browser
Auto Logout
ON - Users are automatically logged out after the application finished.
OFF - Users remain logged in also after the application finished.
Security
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.
Security Module Name
INHERITED - Inherits the configuration set while Configuring Users.
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.
 
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
Data Store
Data Store Module Class Path
Reserved for future use
Data Store Module Name
Reserved for future use
Veryant
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.
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
Remote Debug
ON - Enable remote debug on the isCOBOL Server.
OFF - Disable remote debug on the isCOBOL Server.
Remote debug port
Port number of the Remote Debugger in the isCOBOL Server
Home Folder
Working directory of the application. This is equivalent to the working directory of the isCOBOL Client
Theme
Specifies the decoration theme for the application windows. It affects mainly the title bar and the menu bar of the windows
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 be sure 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 will change the look of the 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 recommended for applications with a lot of graphics content.
JavaFX Support
ON - Ability to use also JavaFx components.
OFF - Only Swing and AWT components allowed.
Compositing Window Manager
Reserved for future use
Enable Debug Mode
Reserved for future use
Enable Test Mode
Reserved for future use
Java
Working Directory
Specifies the working directory of the isCOBOL Client on the machine where WebClient is running.
JRE Executable
Path to the java executable
Java Version
Version of the java executable
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
Launcher Type
Reserved for future use
Session
Session Timeout
Specifies how long the application will be 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.
Logging
Session Logging
ON - log sessions in a separate log file.
OFF - don’t log sessions in a separate log file.
Session Log Size
Maximum size in MB for a session log file
Maximum Session Logs Size
Maximum size in MB of all session log files. When exceeded, the older log files are deleted to gain space
Statistics Logging
ON - log statistics for sessions.
OFF - don’t log statistics for sessions.
Features
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.
Transparent Open File Dialog
ON - when C$OPENSAVEBOX is called to open a file, show only the client-side file browser and upload the selected file.
OFF - when C$OPENSAVEBOX is called to open a file, show the Open dialog along with the client-side file browser and upload the selected file.
Transparent Save File Dialog
ON - when C$OPENSAVEBOX is called to save a file, ask only for the file name.
OFF - when C$OPENSAVEBOX is called to save a file, show the Save dialog along with the prompt for file name.
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.
Allow JsLink
Reserved for future use
JsLink White List
Reserved for future use
Allow Local Clipboard
ON - Allow access to the end user's PC 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.
After changing one or more of the above settings, you can either
Click on "Apply" if you wish to activate the new configuration, or
Click on "Reset" to clean your changes and restore the active configuration.
The application’s configuration is saved in the file webclient/webclient.config under the isCOBOL installation folder.