IBM Support

PM42313: DFHPI0709 PIPELINE RESOLUTION FAILED BECAUSE THE XML CONFIGURATION FILE CANNOT BE COPIED TO THE DERIVED SHELF.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You receive the following message after starting your CICS
    region:
    DFHPI0709E Pipeline resolution failed because the XML
    configuration file cannot be copied to the derived shelf.
    When you look at CICS trace of the problem, you see the
    following exception trace entries:
    DH 0E05 DHFS  *EXC* - NOT_FOUND - FUNCTION(MAKE_HFS_DIRECTORY)
                          PATHNAME(1207E250 , 00000027)
    DH 0E05 DHFS  *EXC* - NOT_FOUND - FUNCTION(WRITE_HFS_FILE)
                          PATHNAME(1207E250 , 00000032)
                          CONTENT(121EC000 , 000004AB , 00000000)
                          CREATE_DIRECTORY(YES)
    .
    Closer examation of the trace will show a timing problem when
    multiple pipelines are being installed at the same time.
    .
    When a pipeline is installed, its directory in the shelf is
    emptied and then deleted. If it was the last pipeline then the
    PIPELINE directory gets deleted. If that was the last resource
    in use for this applid then the applid directory is also
    deleted from the shelf. The required directories are then
    recreated and the config file copied over.
    .
    In this case, 2 other tasks attempted to delete the pipeline
    directory so when the 3rd task tried to copy the HFS file into
    shelf, it did not exist.
    .
    DFHDHFS needs to be changed to add more serialization to protect
    against multiple deletes and writes at the same time.
    .
    Additional Symptoms:
    KIXREVRJL
    

Local fix

  • You can manually discard the pipeline resource definitions and
    install all of your pipelines one at a time.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHPI0709 PIPELINE RESOLUTION FAILED    *
    *                      is issued while install several         *
    *                      PIPELINE resources in a same time.      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    While multiple pipeline resource are installed as the same time
    race condition may cause the installation process fail.
    In condition, WRITE_HFS_FILE is invoked by one task to
    create pipeline's HFS assets. If the directory of config file
    path is empty, MAKE_HFS_DIRECTORY is invoked to create the
    hierarchy directory first. MAKE_HFS_DIRECTORY process is
    protected with serialized CREATE.
    MAKE_HFS_DIRECTORY act in 2 phase: phase 1 will find and create
    the lowest level of directory., phase 2 will create the whole
    hierarchy directory basing on the directory created by phase 1.
    
    Occationally, after the phase 1, dispatcher gives the control
    to the other task which issuing DELETE_HFS_DIRECTORY to delete
    the base directory created in phase 1.
    
    After that, control is given back to the first task and phase 2
    process fails to create the higher level hierarchy directories
    with NOT_FOUND exception.
    
    WRITE_HFS_FILE receive the exception and generate dump and
    error message in trace as below:
    00037 L8005 DH 0E05 DHFS *EXC* NOT_FOUND WRITE_HFS_FILE,1207E250
    
    Key words: DFHDHFS, serialization
    

Problem conclusion

  • DFHDHFS has been changed to make serialization with
    domain call WRITE_HFS_FILE using ENQ/DEQ mechanism.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM42313

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    500

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-06-23

  • Closed date

    2011-09-09

  • Last modified date

    2011-10-03

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

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

    PM44882 PM44883 UK71753

Modules/Macros

  •    DESDHFS  DFHDHFS
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R500 PSY UK71753

       UP11/09/15 P F109

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
03 October 2011