PI21569: DFHML0002 A SEVERE ERROR (CODE X'0305') HAS OCCURRED IN MODULE DFHMLTF.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This problem is very similar to PK93819. The main difference is
  that in this scenario, EXEC CICS TRANSFORM XMLTODATA is being
  used instead of DATATOXML. You can see from the trace that the
  data container exists and has a type of BIT. DFHMLTF is trying
  to do a PUT-CONTAINER with type CHAR and it fails because the
  type does not match.
  Additional Symptom(s) Search Keyword(s): KIXREVACC
  

Local fix

• Use a unique container name for DATA CONTAINER. CICS will build
  this container during the TRANSFORM-XMLTODATA and there is no
  need to pre-populate this container.
  If you must use a previous container for DATA CONTAINER, when
  the previous container was built with PUT-CONTAINER be sure to
  specify the parameter datatype(char).
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Severe error DFHML0002 occurred in      *
  *                      DFHMLTF when an EXEC CICS TRANSFORM     *
  *                      XMLTODATA command was issued.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An application issued an EXEC CICS TRANSFORM XMLTODATA
  command specifying a DATCONTAINER (the target) which already
  existed but which was of the wrong type (CHAR instead of
  BIT).
  DFHMLTF did the transformation of XML to DATA and then issued
  a PUT CONTAINER command to place the resulting output into
  the specified target container. This failed with a
  PGCR PUT_CONTAINER EXCEPTION for reason DATATYPE_CHANGE
  resulting in the reported msgDFHML0002 and an abendAEXZ
  ('Command failed due to a serious failure in a CICS
  component'.)
  Additional Keywords: ML0002 0002 XML MLTF *EXC* AEXZ
                       DATACONTAINER
  

Problem conclusion

• DFHMLTF has been changed to test for an existing target CHAR
  mode container when processing a TRANSFORM of type XMLTODATA.
  If one already exists, it is deleted before any data is put
  into it. Existing code will redefine the target container
  in the correct mode.
  
  CICS Transaction Server for z/OS Version 5 Release 1
  Application Programming Reference, SC34-2845-02 has been
  altered. The description of the 'DATCONTAINER(data-value)'
  option for the 'TRANSFORM XMLTODATA' command has been
  changed to add the following sentence to the end (after
  'CICS populates this container in BIT mode.') :
  "If the container already exists, and has been defined
  as a data type of CHAR, it is deleted and redefined as type
  BIT as part of the command."
  
  CICS Transaction Server for z/OS Version 5 Release 2
  Application Programming Reference , SC34-7267-00 has been
  altered. The description of the 'DATCONTAINER(data-value)'
  option for the 'TRANSFORM XMLTODATA' command has been
  changed to add the following sentence to the end (after
  'CICS populates this container in BIT mode.') :
  "If the container already exists, and has been defined
  as a data type of CHAR, it is deleted and redefined as type
  BIT as part of the command."
  

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:

  UI20755 UI20756

Modules/Macros

• DFHMLTF
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI20755

     UP14/08/30 P F408

• R900 PSY UI20756

     UP14/08/30 P F408

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.