JETTY and JMS Configuration
The webClient service is based on Eclipse Jetty, a Java HTTP (Web) server and Java Servlet container.
The webClient service uses the Java Message Service (JMS) to communicate with the underlying COBOL applications.
Jetty Configuration
By default the service starts on localhost on port 8080.
You can change these settings by editing the file eis/webclient/jetty.properties under the isCOBOL installation folder. It’s good practice to make a backup copy of this file every time you change it, as it may be overwritten by the installation of an isCOBOL SDK update.
Entry | Meaning |
|---|
jetty.webclient.server.host | IP address or machine name where the service listens for connections. Replace ‘localhost’ by the IP of the current PC if you wish to allow connections from other machines in the network. |
jetty.webclient.server.http | Enable or disable listening on the HTTP protocol |
jetty.webclient.server.http.port | Port number the server listens to for HTTP connections |
Note - If you wish to disable the HTTP protocol, don’t comment jetty.webclient.server.http, but set it to "false". If the entry is commented, the webClient service may not start.
The file contains also entries to enable secure HTTP (HTTPS). The entries are commented so by default HTTPS is not enabled. Uncomment and edit the entries if you wish to enable HTTPS.
Entry | Meaning |
|---|
jetty.webclient.server.https | Enable or disable listening on the HTTPS protocol |
jetty.webclient.server.https.port | Port number the server listens to for HTTPS connections |
jetty.webclient.server.https.truststore | Location of the truststore file |
jetty.webclient.server.https.truststore.password | Truststore password |
jetty.webclient.server.https.keystore | Location of the keystore file |
jetty.webclient.server.https.keystore.password | Keystore password |
JMS Configuration
By default JMS uses the port 34455. You can change this port via the webclient.jmsUrl property on the command line.
The value of this property must be specified in the form "nio://<serverNameOrIp>:<port>".
For example, in order to start webClient on localhost using the port 12345 for JMS, use this command:
• Windows
cd %ISCOBOL%\bin webcclient.exe -J-Dwebclient.jmsUrl=nio://127.0.0.1:12345 |
• Linux
cd $ISCOBOL/bin ./webcclient -J-Dwebclient.jmsUrl=nio://127.0.0.1:12345 |