A fix is available
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:
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