Testing the product using the isCOBOL Demo program (Iscontrolset)
In this guide we’re going to run the isCOBOL Demo program (Iscontrolset) in a web browser through isCOBOL WebClient.
Before you start the WebClient service, it’s good practice to ensure that the isCOBOL Thin Client can execute the program correctly. So, ensure that this command opens the isCOBOL Demo program:
iscclient -hostname <yourAppServerNameOrIp> ISCONTROLSET |
The above command assumes that there is an isCOBOL Server running on the machine identified by yourAppServerNameOrIp and the folder containing ISCONTROLSET.class is in the Server’s Classpath or code-prefix.
See isCOBOL Evolve: Application Server for more information about how to start programs in a thin client environment.
Once the above command works correctly, you can start the WebClient services.
Note - If you wish to connect to the web application from different machines in the network in addition to your PC, then the service must be listening on the IP address of the PC instead of localhost. You can configure this setting in Jetty Configuration.
Use the following command to start the WebClient service:
• Windows
cd %ISCOBOL%\bin webcclient.exe |
• Linux
cd $ISCOBOL/bin ./webcclient |
A correct startup shows a message like this at the bottom of the console output:
INFO:oejs.Server:main: Started @3791ms |
Use the following command to start the WebClient Admin Console service:
• Windows
cd %ISCOBOL%\bin webcclient-admin.exe |
• Linux
cd $ISCOBOL/bin ./webcclient-admin |
A correct startup shows a message like this at the bottom of the console output:
INFO:oejs.Server:main: Started @4082ms |
When both the WebClient service and the WebClient Admin Console service are up and running, you can navigate to http://machine-ip:port with a web browser.
Note - machine-ip and port must match the server.host and server.http.port values set Jetty Configuration.
You will get this screen:
Log in as user "admin" with password "admin", you will get this screen:
Click on "Manage" and you will get this screen:
Click on "Create New App" in the bottom left corner of the page and you will get this screen:
Type "demo" in the field. This is the name that will be used in the URL in order to use the COBOL application. Note that this name cannot be changed after the application is created.
Click on "Create" and you will be redirected to the configuration of the application:
Note - in this page applications are listed in alphabetical order and the first application in the list is selected when the page is loaded. You may need to click on your application name in the list on the left in order to load its configuration on the right
Click the Enable button in order to activate the application, then scroll down to reach the App Configuration section:
Type "ISCONTROLSET" (upper case) in the Program name and arguments field.
See Change the application configuration for more details about the configuration of a WebClient application.
Click on "Apply" when prompted.
At this point you can test your application from any web browser from any machine in the network by navigating to: http://machine-ip:port/demo.
Note - machine-ip and port must match the server.host and server.http.port values set Jetty Configuration.
