A fix is available
APAR status
Closed as program error.
Error description
Changed MRO connection to IPIC connections and start seeing the following message. . DFHPG0002 A severe error (code X'1709') has occurred in module DFHPGCH. . Looking in Internal Trace you'll see the following Trace Entry. . PG 1709 PGCH *EXC* - INVALID_LINK_LEVEL - FUNCTION(INQUIRE_CHANNEL) CHANNEL_NAME(DFHTRANSACTION) . The STACK looks like so in the Kernel Domain . DFHKETA DFHDSKE DFHXMTA DFHDPXM BIND_XM_CLIENT DFHDPPM PATTERN_MATCH_TASK DFHDPFM START_PM_BROWSE DFHFCFR ACCMTEST DFHFCRF SHIP_REQUEST DFHISIS DFHISIS_CONVERSE DFHPGCH INQUIRE_CHANNEL SEVERE_ERROR DFHMEME SEND CONTINUE_SEND DFHDUDU SYSTEM_DUMP TAKE_SYSTEM_DUMP . The transactions run without problems but these errors continue to come out. . A CICS task starts, and because DEBUGTOOL=YES is specified, DP domain issues a FC read to the CADP repository. The region has defined the repository files as REMOTE - connected through IPIC... so the FC request goes out through IS. IS asks PG if there is a DFHTRANSACTION channel. PG sees that there are no PLCBs (because we are so early in the life of the transaction) and raises the Severe Error. If you look at this TASK in the PG Domain it looks like so. . ==PG: PTA SUMMARY FOR TRAN NUM : 11111, PTA ADDRESS : 11118888 LOG-LVL : 0 SYS-LVL : 0 TASK-LLE : 00000000 PLCB 00000000 . IS should not be attempting to send DFHTRANSACTION to the remote system on a Function Shipped File Control request. . Additional Symptom(s) Search Keyword(s): KIXREVDAM
Local fix
n/a
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: CICS reports error DFHPG0002 with * * (CODE X'1709') when a Function Shipped * * File Control request is sent over an * * IPIC connection early in the life of * * a CICS transaction. * **************************************************************** * RECOMMENDATION: . * **************************************************************** A CICS transaction starts and, before invoking any application program, issues a Function Ship request to a remote region which is connected through IPIC. In the reported error, the Function Ship request was a File Control STARTBR (start browse) on behalf of DP domain because the CICS region was configured with the system initialization parameter DEBUGTOOL set to YES. IS domain asks PG domain if the transaction has a DFHTRANSACTION channel - with the intention of sending it across the link. PG domain sees that it has been called at a point where it has not yet invoked any application code and reports the situation as a Severe Error - DFHPG0002 (CODE X'1709'). IS domain should not be attempting to send the DFHTRANSACTION channel across the link for a File Control request. DFHTRANSACTION should only be sent on Distributed Program Link (DPL) requests.
Problem conclusion
DFHISIS has been changed to prevent it from shipping the DFHTRANSACTION channel on requests that are not for DPL processing. The CICS Knowledge Center and the CICS 5.3 Application Programming Guide ( SC34-7401-00 ) page 270 will be updated. In the section, "The transaction channel DFHTRANSACTION" the following sentences will be added: "Transaction channels are shipped on DPL requests. They are not shipped on other function shipped requests so are not available to exits on the target region."
Temporary fix
Comments
APAR Information
APAR number
PI87386
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
000
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-09-14
Closed date
2017-10-05
Last modified date
2017-11-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI50896 UI50897
Modules/Macros
DFHISIS
SC34740100 | SK4T273700 |
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
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":"5.3","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":"5.3","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 November 2017