PH02403: 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 of Enterprise COBOL V6.2 who need to   *
  *                 process JSON input text that does not        *
  *                 specify 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: Apply 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
  
  FIXCAT keyword: COB0501T/K  COB0502T/K  COB0601T/K  COB0602T/K
  

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:

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

  PH02802

Modules/Macros

• IGZXLPKA
  

Fix information

• Fixed component name

  LE ENT COBOL LI

• Fixed component ID

  568819812

Applicable component levels

• R7A0 PSY UI58595

     UP18/09/27 P F809

• R790 PSY UI58596

     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.