PH02802: ADD RUN-TIME SUPPORT FOR A NEW KEYWORD OMITTED IN THE NAME PHRASE IN JSON PARSE STATEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Given the following JSON text and JSON STATEMENT,
  the parsing is not successful. Users need a way to
  parse it.
  
    01 A.
      02 NAME1 PIC X(6).
      02 NAME2 PIC X(6).
  
    JSON-text is
      {"NAME1": "VALUE1", "NAME2": "VALUE2"}
  
    JSON PARSE JSON-text INTO A
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users need support of processing JSON        *
  *                 input which is missing the root data         *
  *                 item identifier name.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Users need support of processing JSON   *
  *                      input which is missing the root data    *
  *                      item identifier name.                   *
  ****************************************************************
  * RECOMMENDATION: Install the provided PTF.                    *
  ****************************************************************
  NEW FUNCTION.
  Given the following JSON input text and JSON STATEMENT, the
  parsing would not be successful as the root data item
  identifier
  is missing from the JSON input.
  
   01 A.
   02 NAME1 PIC X(6).
   02 NAME2 PIC X(6).
  
   JSON-text is
   {"NAME1": "VALUE1", "NAME2": "VALUE2"}
  
   JSON PARSE JSON-text INTO A
  

Problem conclusion

Temporary fix

Comments

• NEW FUNCTION.
  The COBOL runtime library has been enhanced to support new
  syntax in the JSON PARSE statement. COBOL programs that contain
  this new syntax need to be recompiled using a COBOL compiler
  with APAR PH02251 installed, and run with the current runtime
  APAR installed.
  
  The optional keywords "NAME ... OMITTED" are added to the JSON
  PARSE statement:
  
  JSON PARSE identifier-1 INTO identifier-2
   [ NAME identifier-2 OMITTED ]
   ...
  
  Usage example.
  The following JSON PARSE statement would be successful when
  processing the JSON input text described in "Problem Summary"
  above:
  
   JSON PARSE JSON-text INTO A
   NAME A OMITTED
  

APAR Information

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

  PH02403

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

Modules/Macros

• IGZBALCT IGZCEV4  IGZCMGEN IGZCMGJA IGZCMGUE IGZEDCCT IGZIBMCT
  IGZIGZCT IGZLLIBV IGZXAPI  IGZXCDA  IGZXD24  IGZXDMR  IGZXFBIN
  IGZXFHEX IGZXLPIO IGZXLPKA IGZXLPKB IGZXLPKC IGZXLPKD IGZXLPKE
  IGZXLPKF IGZXLPKG IGZXNMVF IGZXNVFQ IGZXPK2  IGZXTNMV IGZXTNVC
  IGZXTNVF IGZXUNFQ IGZXUNVF
  

Fix information

• Fixed component name

  LE ENT COBOL LI

• Fixed component ID

  568819812

Applicable component levels

• R7B0 PSY UI58603

     UP18/09/27 P F809

• R7BJ PSY UI58604

     UP18/09/27 P F809

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.