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
| Your current version | Action | Mandatory or optional? |
|---|---|---|
| Change the JCL that calls the JSON assistant | Mandatory | |
| Exploit the data mapping of COBOL OCCURS clauses | Optional | |
| Enable the transformation of UTF-16 data | Optional |

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.
- 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.
- 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.

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.

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.