A fix is available
APAR status
Closed as program error.
Error description
Your CICS region starts up and you see the following informational message in the job output: . DFHHC0102I applid CICS failed to register with the z/OS Health Checker: code( X'00000003') reason( X'00000008') response( X'0000081C'). . You attempt to investigate the issue and look at internal trace for the region, and find the following exception trace is written when this occurs: . XS FE04 XS** *EXC* FUNCTION(REGISTER_TO_HEALTH_CHECKER) RESPONSE(EXCEPTION) REASON(CSVDYNEX_FAILED) ESM_RESPONSE(8) ESM_REASON(81C) . Because this comes out of the XS (Security) domain, and because the trace indicates that the ESM (External Security Manager) returned the response and reason, you logically focus your efforts on what may have happened in RACF (or your current ESM.) . The trace is misleading, as this is not a security related issue, and no calls were made to the ESM in this case. The DFHHC0102I message documentation also does not indicate what MVS macro was issued, and where to look for these code/reason/response combinations. The true cause was a failure to load one of the health checker modules, but the documentation and trace are not adequate to help you determine the course of action to take. This APAR is being opened to correct the misleading trace entry and to correct the missing documentation items. . Additional Symptom(s) Search Keyword(s): KIXREVSWM
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICS users. * **************************************************************** * PROBLEM DESCRIPTION: Improvements to the diagnostics for * * the CICS healthchecker. * **************************************************************** CICS Message DFHHC0102 returns error code, reason and response values, but it is not clear what these values are or where they are documented. Also, if CICS issues exception trace entry XS FE04 then it refers to esm_response and esm_reason values when these are not always applicable to an External Security Manager. KEYWORDS: msgdfhhc0102 hc0102 0102 102 health checker XSFE04
Problem conclusion
CICS has been changed to specify interface_response and interface_reason (rather than esm_response and esm_reason) on the calls for healthchecker operations. DFHHC0102 has been changed to include the following additional guidance: "The code for the failure denotes the macro call that has failed. 1 = GETMAIN, 2 = IARV64, 3 = CSVDYNEX, 4 = HZSCHECK. Depending upon the failure code, refer to the following: The GETMAIN macro is described in the z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG. The IARV64 macro is described in the z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG. The CSVDYNEX macro is described in the z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN. The HZSCHECK macro is described in the IBM Health Checker for z/OS Users Guide."
Temporary fix
Comments
APAR Information
APAR number
PI96645
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-04-12
Closed date
2018-06-21
Last modified date
2018-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI56673 UI56674 UI56757 UI56758
Modules/Macros
DFHBSTS DFHCRNP DFHD2EX1 DFHD2TM DFHEIQD2 DFHERM DFHHCC1 DFHHCC2 DFHHCC3 DFHHCHK DFHICP DFHICUS DFHIEIE DFHISCO DFHISDM DFHISIC DFHISIS DFHISXM DFHL2BL1 DFHLGLD DFHMEHCE DFHMQTM DFHPAGP DFHPIPL DFHRZDM DFHRZIX DFHRZLN DFHRZNR2 DFHRZRG2 DFHRZRM DFHRZRS1 DFHRZSO DFHRZSO1 DFHRZTA DFHRZTCX DFHRZTR1 DFHRZTRI DFHRZXM DFHSAIQ DFHSHDM DFHSHPR DFHSHRE1 DFHSHRM DFHSHRQ DFHSHRQ1 DFHSHRR DFHSHTI DFHSHXM DFHSJDM DFHSJJS DFHSJXM DFHSNSC DFHSNSU DFHSNTU DFHSOAD DFHSODM DFHSOXM DFHTDTM DFHUSDM DFHUSES DFHWBXM DFHXMTA DFHXMXD DFHXSDM DFHXSIS DFHXSIST DFHXSSI DFHXSSIT DFHXSSJ DFHXSSJT DFHZCN2 DFHZNAC DFHZSLS
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R000 PSY UI56757
UP18/06/22 P F806
R100 PSY UI56758
UP18/06/23 P F806
R800 PSY UI56673
UP18/06/23 P F806
R900 PSY UI56674
UP18/06/23 P F806
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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2018