Upgrading SOAP web services

If you use SOAP web services, you have some changes to make when you upgrade your version of CICS®.

V4.1

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.

V4.1

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.

V41, V4.2, and V5.1

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.

V41, V4.2, and V5.1

Exploit the data mapping of COBOL OCCURS clauses

CICS now provides data mapping to support COBOL OCCURS DEPENDING ON and OCCURS INDEXED BY 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.
V41, V4.2, and V5.1

Enable the transformation of UTF-16 data

CICS now provides support for transforming application data that is encoded in UTF-16 at a mapping level of 4.0 or higher.
  • 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.


upgrade_soap.html | Timestamp icon Last updated: Sunday, 4 June 2017