Configuring the web client

Before you can use the web client, you must deploy the Java web archive (WAR) for the web client front end into one of the supported environments and configure it to call the appropriate endpoints in your CICS® system.

About this task

The following environments are supported for the two versions of web client front end application ExampleAppClientV855.war and ExampleAppWrapperClientV855.war:
  • CICS Liberty JVM server with the latest WebSphere Liberty Profile
The WAR files are located in the hlq /samples/webservices/client directory in z/OS UNIX.

Procedure

  1. To start the web client enter the following URL in your web browser, where mylibertyserver is the host name of the Liberty JVM server on which the web client is installed.
    • For ExampleAppClientV855.war, use URL http://mylibertyserver:9080/ExampleAppClientV855/
    • For ExampleAppWrapperClientV855.war, use URL http://mylibertyserver:9080/ExampleAppWrapperClientV855/
    The example application displays the following page:
    WELCOME page for the CICS Example Application
  2. Click CONFIGURE to display the configuration page.
    The configuration page is displayed.
    Configuration screen for the CICS Example Application
  3. Enter the new endpoint for the web service of Inquire catalog, Inquire item, and Place order.
    1. In the URLs replace the string myCicsServer with the name of the system on which your CICS is running.
    2. Replace the port number 8080 with the port number configured in the TCPIPSERVICE definition resource.
  4. Click SUBMIT.

Results

The web application is now ready to run.

What to do next

The URL for the web services invocation is stored in an HTTP session. It is therefore necessary to repeat this configuration step each time a web browser is first connected to the client.