PM30503: DFHSC2LS OVERWRITES THE CONTENT OF THE EXISTING CICS.XML IF IT RUNS TWO TIMES ON SAME BUNDLE PATH

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• We run XML assistant DFHSC2LS to create an XMLTRANSFORM and an
  XML binding file from a high-level language structure.
  The application is composed by 2 different .xsd ( responce and
  request) but part of the same bundle.
  He wants to put both XMLTRANSFORM in the same BUNDLE so both JOB
  specify the same BUNDLE path.
  If you install the BUNDLE resource, CICS dynamically creates an
  XMLTRANSFORM resource that defines where the XML binding and
  schema are located,  this will result in the previous
  XMLTRANSFORM resource being loosed leading to failure in a
  previously running application because CICS.XML is overwrittem
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL CICS Users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHSC2LS overwrites the content of the  *
  *                      CICS.XML in an exsiting bundle.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The XML assistants (DFHLS2SC or DFHSC2LS) are used to create a
  BUNDLE to install in to CICS.  If the directory specified by
  the BUNDLE parameter already contains a CICS BUNDLE then the
  cics.xml file that describes the content of the BUNDLE will be
  overwritten.  The cics.xml file will now only reference the
  XMLTRANFORM (XSDBIND file) that was just created and not any
  other resources that may have been in the existing BUNDLE.
  This could lead to application failures in CICS when the BUNDLE
  is next installed as their required resources will not have
  been installed.
  

Problem conclusion

• A new parameter OVERWRITE-OUTPUT has been added to DFHLS2SC
  and DFHSC2LS, this parameter controls whether the exsiting
  BUNDLE on the file system can be overwritten.
  
  If OVERWRITE-OUTPUT=YES, any exsiting BUNDLE file will be
  replaced and message DFHPI9683W will be issued to indicate.
  this has happened.
  
  IF OVERWRITE-OUTPUT=NO, any exsiting BUNDLE file will not be
  replaced and error message DFHPI9686E will be issued and the .
  tool will terminate.
  
  DOC Changes:
  CICS Transaction Server for z/OS Version 4 Release 1
  Application programming guide SC34-7022-01
  Chapter 28. Mapping and transforming application data and XML
   In Section: DFHLS2SC: high-level language to XML schema
               conversion
    Add the following to input parameters for DFHLS2SC
  
       >--+-OVERWRITE-OUTPUT=NO--+---------------------------><
          +-OVERWRITE-OUTPUT=YES-+
  
    Add the description of the OVERWRITE-OUTPUT option to the
    parameter descriptions section.
    Parameter descriptions,
  OVERWRITE-OUTPUT = {NO | YES }
  
     Controls whether existing CICS BUNDLEs on the file system
     can be overwritten.
  
   NO
     Any existing BUNDLE will not be replaced.  If an existing
     BUNDLE is found DFHLS2SC will issue error message
     DFHPI9686E and terminate.
   YES
     Any existing BUNDLE will be replaced.  If an existing
     BUNDLE is found then message DFHPI9683W will be issued
     to inform you that the file has been replaced.
  
  The same changes will be made in section DFHSC2LS: XML
  schema to high-level language conversion
  
  CICS Transaction Server for z/OS Version 4 Release 1
  CICS Messages and Codes
  GC34-7035-01
  Add the new message DFHPI9686E in section
  "DFHPInnnn messages"
  DFHPI9686E Bundle directory dirName already exists and
             will not be replaced because OVERWRITE-OUTPUT=NO
             is specified.
  Explanation: The XML assistant has detected that a CICS
  bundle already exists at the location specified by the
  BUNDLE parameter.  OVERWRITE-OUTPUT=NO was specified, or
  allowed to default.  This prevents the new bundle from
  being created.
  System action: The XML assistant terminates.
  
  User response: If you want the bundle to be replaced then
  rerun the XML assistant with OVERWRITE-OUTPUT=YES specified.
  If the existing bundle is not to be replaced then rerun with
  a different location specified for the BUNDLE parameter.
  
  Module: DFHLS2SC, DFHSC2LS
  
  Destination: SYSPRINT
  

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:

  UK66984 UK66985 PM46934

Modules/Macros

•    DFHMEPIC DFHMEPIE DFHMEPIK DFJ@H176 DFJ@H223
  DFJ@H236 DFJ@H237
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60D PSY UK66985

     UP11/05/10 P F105

• R600 PSY UK66984

     UP11/05/10 P F105

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.