A fix is available
APAR status
Closed as program error.
Error description
During region termination, the CICS region received these messages and a dump: . DFHTM1715 CICS is being quiesced by ... DFHDM0102I CICS is quiescing. DFHIS0002 A severe error (code X'0688') has occurred in module DFHISXM. DFHME0116 (Module:DFHMEME) CICS symptom string for message DFHIS0002 is PIDS/5655Y0400 LVLS/690 MS/DFHIS0002 RIDS/DFHISXM PTFS/UI39248 PRCS/00000688 DFHDU0201 ABOUT TO TAKE SDUMP. DUMPCODE: IS0002 ... . A transaction was routed over an IPIC connection from a TOR and the region attempted to attach transaction CITS to install the remote terminal. But, this failed because the transaction is not able to start during shutdown. . DFHAC2007 Transaction CITS cannot run as CICS shutdown is in progress. DFHIS1025 Failed to attach mirror transaction ... on IPCONN PT2 Error code is X'061A'. DFHIS1021 Session error occurred on RECEIVE IPIC session in IPCONN ... . CICS internal trace in the dump shows that abend AZTC started but while processing the abend, this trace entry was issued: . AP 0688 ISXM *EXC* APRA_FAILURE FUNCTION(INIT_XM_CLIENT) CLIENT_REQUEST_BLOCK(22642A08 , 00000108) . The severe IPIC error is not necessary in this case. . The TOR reported an AZTS abend. . Additional Symptom(s) Search Keyword(s): KIXREVRJL
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users * **************************************************************** * PROBLEM DESCRIPTION: Message DFHIS0002 severe error * * (code X'0688') has occurred in module * * DFHISXM, is issued during CICS * * shutdown. * **************************************************************** A TOR routed a transaction to an AOR over an IPIC connection. The AOR was being quiesced and it was not possible to attach the user transaction and the CITS transaction, to install a surrogate terminal, because the user transaction and CITS are not enabled for shutdown. DFHAPRA sent an APRA_DISASTER response to DFHISXM and this provoked the taking of a system dump and issuing of a DFHIS0002 severe error message. Additional keywords: MSGDFHIS0002 IS0002 MSGDFHTM1715 TM1715 MSGDFHDM0102 DM0102 MSGDFHIS1025 IS1025 MSGDFHIS1021 IS1021 MSGDFHAC2007 AC2007 MSGDFHDM0102I
Problem conclusion
CICS has been changed so DFHAPRA sends a response of APRA_INVALID with reason APRA_REMOTE_TERMINAL_FAILURE when it is not possible to attach CITS during shutdown.
Temporary fix
Comments
APAR Information
APAR number
PI87117
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
900
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / CST / Xsystem
Submitted date
2017-09-11
Closed date
2018-01-16
Last modified date
2018-02-06
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI53226 UI53227 UI53228
Modules/Macros
DFHAPRA
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R000 PSY UI53228
UP18/01/17 P F801
R100 PSY UI53227
UP18/01/17 P F801
R900 PSY UI53226
UP18/01/18 P F801
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.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":"5.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
06 February 2018