PI87386: DFHPG0002 (CODE X'1709') IN DFHPGPH WHEN USING IPIC.

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

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

  UI50896 UI50897

Modules/Macros

• DFHISIS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI50897

     UP17/10/07 P F710

• R100 PSY UI50896

     UP17/10/07 P F710

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.