Upgrading JSON web services

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

Upgrade actions

V41, V4.2, and V5.1

Change the JCL that calls the JSON assistant

In previous releases, the JSON assistant batch jobs DFHJS2LS and DFHLS2JS were provided as part of CICS TS Feature Pack for Mobile Extensions. These functions are now incorporated into CICS TS, so you must change any JCL that calls the assistant.
  1. Change the JCL procedure library where DFHJS2LS or DFHLS2JS are located. From CICS TS 5.2, these batch jobs are in the HLQ.XDFHINST library.
  2. Review the values of the symbolic parameters JAVADIR, PATHPREF, and USSDIR. From CICS TS 5.2, you might not need to specify them at all because the DFHJS2LS and DFHLS2JS procedures are customized by DFHISTAR. For more information about these parameters, see DFHJS2LS: JSON schema to high-level language conversion for request-response services in the IBM Knowledge Center and DFHLS2JS: High-level language to JSON schema conversion for request-response services in the IBM Knowledge Center.
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_json.html | Timestamp icon Last updated: Sunday, 4 June 2017