PM47098: DFHAP0002 A SEVERE ERROR (CODE X'0657') OCCURRED IN MODULE DFHALXM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer is receiving the following DFHAP0002 message,
  MESSAGE:   DFHAP0002 A severe error (code X'0657') has
  occurred in module DFHALXM.
  SYMPTOMS:  PIDS/5655S9700 LVLS/660 MS/DFHAP0002 RIDS/DFHALXM
  PTFS/HCI6600 PRCS/00000657
  The trace shows the following,
  AP 1791 TFXM  EXIT  BIND_XM_CLIENT/OK
  LINK_APPLICATION_PROGRAM() APPLICATION_PROGRAM(...)
  PG 1701 PGCH  EXIT  BIND_CHANNEL/EXCEPTION
  REASON(CHANNEL_ALREADY_SET)
  AP 0657 ALXM  *EXC* UNEXPECTED_PGCH_FAILURE
  .
  Additional Keywords: UNEXPECTED_PGCH_FAILURE CHANNEL_ALREADY_SET
  KIXREVTGL
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  *                                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHAP0002 A severe error (code X'0657') *
  *                      has occurred in module DFHALXM.         *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A transaction, TRA1, running on a terminal, issues an EXEC CICS
  START TRANSID(TRA2) TERMID(EIBTRMID) CHANNEL(CHANNEL2). This
  causes an AID to be created and the CHANNEL token for CHANNEL2
  is saved in the AID field AID_CHANNEL_TOKEN.
  
  TRA1 terminates by issuing an EXEC CICS RETURN TRANSID(TRA3)
  CHANNEL(CHANNEL3), and the CHANNEL token for CHANNEL3 is saved
  in the TCTTE field TCTTECTK.
  
  As soon as TRA1 terminates, thus freeing the terminal, the AID
  which was created earlier causes the terminal to be ATIed
  immediately and transaction TRA2 starts before TRA3.
  
  During initialization of TRA2, routine BIND_XM_CLIENT in module
  DFHAXLM calls BIND_XM_CLIENT in module DFHTFXM, which BINDS the
  CHANNEL found in the TCTTECTK field (CHANNEL3).
  
  However, upon return, since it finds a CHANNEL token in
  AID_CHANNEL_TOKEN, DFHAXLM attempts to BIND the CHANNEL to the
  task. This fails, since the task already has a BOUND CHANNEL as
  a result of the BIND performed by DFHTXFM earlier.
  
  Consequently message 'DFHAP0002 A severe error (code x'0657')
  has occurred in module DFHAXLM' is issued.
  
  Additional Keywords: MSGDFH0002 DFHPGCH PGCH_CHANNEL_ALREADY_SET
  

Problem conclusion

• DFHTFXM, DFHXTP, DFHAPRX and DFHAPRR have been changed to
  ignore the TCTTE CHANNEL token in field, TCTTECTK, unless the
  task has been started by terminal input.
  

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:

  UK74990 UK74991

Modules/Macros

• DESAPRR  DESAPRX  DESTFXM  DFHAPRR  DFHAPRX
  DFHTFXM  DFHXTP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK74990

     UP11/12/23 P F112

• R700 PSY UK74991

     UP11/12/23 P F112

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.