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
The WAR files are located in the
hlq
/samples/webservices/client
directory in z/OS® UNIX.
Procedure
-
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/
-
Click CONFIGURE to display the configuration page.
The configuration page is displayed.
-
Enter the new endpoint for the web service of Inquire catalog,
Inquire item, and Place order.
-
In the URLs replace the string
myCicsServer
with the name of the
system on which your
CICS
is running.
-
Replace the port number
8080
with the port number configured in
the TCPIPSERVICE definition resource.
-
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.