Upgrading SOAP web services
If you use SOAP web services, you have some changes to make when you upgrade your version of CICS®.
Upgrade actions
| Your current version | Action | Mandatory or optional? |
|---|---|---|
| Exploit connection pooling for performance benefits | Optional | |
| Exploit the additional URIMAP resource from a pipeline scan | Optional | |
| Enable SOAP message validation in a JVM server | Mandatory | |
| Package WEBSERVICE resources in CICS bundles | Optional | |
| Exploit the data mapping of COBOL OCCURS clauses | Optional | |
| Enable the transformation of UTF-16 data | Optional |
Exploit connection pooling for performance benefits
Connection pooling can provide performance benefits where a service requester application makes multiple requests and responses. When you implement connection pooling, CICS keeps the client HTTP connection open after the application finishes making its request and receiving its response. The application can reuse the connection to make further requests and responses, rather than opening a new connection each time. Connection pooling is specified on the URIMAP resource for a client HTTP connection, so the application must specify a URIMAP resource on the INVOKE SERVICE command.
Exploit the additional URIMAP resource from a pipeline scan
A pipeline scan produces a second URIMAP resource for each WSDL document that is present in the pickup directory. This URIMAP resource defines a URI that points to the location of the WSDL document. You can use this URI to publish WSDL documents so that external requesters can create web service applications.
Enable SOAP message validation in a JVM server
SOAP message validation is now performed in a JVM server. To enable SOAP message validation, you must set up a JVM server in the CICS region. JVM servers can run different workloads, and SOAP validation can run in a JVM server that is configured to support an OSGi framework or Axis2. SOAP validation cannot run in a Liberty JVM server.
The DFHPIVAL program must refer to a JVMSERVER resource. By default, the program uses the sample JVM server, DFHJVMS. To change the JVM server, edit the DFHPIVAL definition in group DFHPIVAL.

Package WEBSERVICE resources in CICS bundles
WEBSERVICE resources can now be defined and packaged in CICS bundles. The resource is dynamically installed in the CICS region when you install the BUNDLE resource. You can import a web service binding file and a WSDL document or WSDL archive file to be packaged with the resource definition, and for a service provider you can include a PROGRAM definition in the bundle. You can also use an existing WEBSERVICE definition in a CICS bundle to generate related URIMAP resources and alias transactions.

Exploit the data mapping of COBOL OCCURS clauses
- The OCCURS DEPENDING ON clause is supported at a mapping level of 4.0 or higher. Complex OCCURS DEPENDING ON is not supported. This limitation means that OCCURS DEPENDING ON is only supported for the last field of a structure.
- The OCCURS INDEXED BY clause is supported at any mapping level.

Enable the transformation of UTF-16 data
- You can enable this behavior by using language-specific data types for UTF-16 when you use the DFHLS2JS, DFHLS2SC, or DFHLS2WS assistants.
- You can enable this behavior by setting CCSID=1200 when you use the DFHJS2LS, DFHSC2LS, or DFHWS2LS assistants.