Deploying a Java provider-mode web service in a Liberty JVM server

You can deploy a web application as a provider mode web service in a Liberty JVM server. These applications are created using Java™ standards JAX-WS and JAXB. This topic applies to CICS® integrated-mode Liberty only.

About this task

CICS TS V5.3 includes the latest WebSphere® Liberty that provides features for the Java API for XML Web Services (JAX-WS) and the Java Architecture for XML Binding (JAXB). Together these technologies enable you to write SOAP web services in Java as part of a CICS application. The following article will show you how to set up Eclipse, test a sample web services project, deploy the sample into CICS , modify the sample to use JCICS and test it with the Web Service Explorer. For more information, see the CICS DevCenter article, JAX-WS web service sample for Liberty.

You might want to deploy Java applications using this method for one of the following reasons:

You want to create web services in Java.
You have complicated WSDL documents that would be difficult to handle using the CICS web services assistants.
You want to offload the handling of the web service application to the IBM® z Systems® Application Assist Processor (zAAP).

Note: Web applications deployed to a Liberty JVM server do not use the WEBSERVICE or TCPIPSERVICE resources. They interact with web requests using the Liberty HTTP listener and therefore cannot use the facilities of the CICS web services support.