PI47466: JSON TRUNCATING SPACES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using DFHJS2LS to convert Cobol to JSON schema,
  if a string field contains more than one consecutive space
  it returns with only one space when it
  goes thru the JSON utility for transformation.
  The CHAR-VARYING = COLLAPSE option does not help.
  .
  Additional keywords KIXREVDAM
  Leading Trailing Embedded blank blanks spaces JASON
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: JSON transformation collapses white     *
  *                      space.                                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DFHJS2LS is used to create a web service from a JSON schema.
  Subsequently when transformation of JSON to/from application
  data takes place, leading and trailing white space is removed.
  Consecutive embedded white space is collapsed to a single
  space.
  This occurs because web services created using DFHJS2LS use
  the collapse behaviour of the whiteSpace facet as described in
  the XML Schema specification.
  

Problem conclusion

• The DFHJS2LS assistant has been modified to support a new
  optional CHAR-WHITESPACE parameter, which can be specified
  with values of COLLAPSE, REPLACE or PRESERVE.
  When specified, the value of this parameter is used for all
  string fields, except those defined with a format of date-time,
  uri, base64Binary or hexBinary.  These formats will always use
  the collapse behaviour to be consistent with the XML Schema
  specification which states that collapse is the only valid
  value for these formats.
  If the parameter is not specified, then the default of collapse
  is used.
  
  The CICS Transaction Server 5.1.0 section of the IBM Knowledge
  Center will be updated.  The topics listed below, which are
  found in the Reference material for the CICS Transaction
  Server for z/OS Feature Pack for Mobile Extensions V1.0, will
  be modified as follows.
  
  - DFHJS2LS: JSON schema to high-level language conversion for
  linkable interface
  - DFHJS2LS: JSON schema to high-level language conversion for
  request-response services
  - DFHJS2LS: JSON schema to high-level language conversion for
  RESTful services
  
  In each of these topics, the diagram under the "Input
  parameters for DFHJS2LS" heading will have a new optional
  parameter, CHAR-WHITESPACE, added, which can have a value of
  COLLAPSE, REPLACE or PRESERVE.
  
  Under the "Parameter descriptions" heading, after CHAR-
  VARYING-LIMIT, the following parameter description will be
  added.
  
  CHAR-WHITESPACE=COLLAPSE|REPLACE|PRESERVE
  Specifies how white space in values of type string will be
  handled by CICS.
  - A value of collapse means that leading, trailing, and
  embedded white space is removed and that all tabs, new lines,
  and consecutive spaces are replaced with single space
  characters.
  - A value of replace means that any tabs or new lines are
  replaced with the appropriate number of spaces.
  - A value of preserve retains any white space in the data
  value.
  If the CHAR-WHITESPACE parameter is not set, white space will
  be collapsed.  Note: this parameter does not apply to fields
  with a format of date-time, uri, base64Binary or hexBinary,
  where white space is always collapsed.
  
  These topics will also be updated in the CICS Transaction
  Server 5.2.0 section of the IBM Knowledge Center, and the
  associated PDF collections.  For CICS TS 5.2, these topics can
  be found in the Creating the web services infrastructure,
  section.
  
  The DFHJS2LS: JSON schema to high-level language conversion
  for linkable interface topic can be found in Chapter 20.
  Mapping and transforming application data and JSON, of the
  CICS Transaction Server for z/OS Version 5 Release 2
  Application Programming Guide (SC34-7266-00).
  The DFHJS2LS: JSON schema to high-level language conversion
  for request-response services, and DFHJS2LS: JSON schema to
  high-level language conversion for RESTful services, topics
  can be found in Chapter 8. Creating a JSON web service, of the
  CICS Transaction Server for z/OS Version 5 Release 2 Web
  Services Guide (SC34-7301-00).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI32548 UI32549

Modules/Macros

• DFJ@H176
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R80D PSY UI32548

     UP15/11/05 P F511

• R90D PSY UI32549

     UP15/11/05 P F511

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.