PH58623: GENERAL INTERNAL IMPROVEMENTS TO THE CICS HEALTHCHECKER FUNCTION AT CICS TS 6.1.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• General internal improvements to the CICS healthchecker function
  at CICS TS 6.1.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: z/OS Health Checker using the same      *
  *                      response bit to report disaster as well *
  *                      as health check failure message.        *
  ****************************************************************
  z/OS Health Checker runs the CICS health checks to find checks
  which fail, they set flag bits into the 2 byte COMMAREA which is
  to be returned. When it is examined in DFHHCCHK, messages are
  issued dependent upon which flags are set. This allows up to 16
  messages to be issued from one health check module.
  
  If various things go wrong within an individual check, a
  DISASTER response is set and reported with RC 1000 in the
  information written to the CICS health check report.
  
  With the recent health check enhancements for CICS TS 6.1, the
  DISASTER bit was also being used as a flag bit. This means, the
  bit could be used to issue either health check failure message
  or a failure in one of the domain calls and cause confusion.
  

Problem conclusion

• CICS has been changed to use other free bits in the COMMAREA to
  report health check failure messages. Also, a new message is
  added in each health check module to report disaster that one
  or more tests have failed within the suite of checks.
  
  The new messages being added are DFHH0415, DFHH0506, DFHH0604,
  DFHH0709 and DFHH0811.
  
  Following new messages are added in health check modules to
  report disaster that one or more tests have failed within the
  suite of checks.
  
  1. DFHHCC4 related changes
  
  1.1 New message DFHH0415
  
  DFHH0415 The health check did not complete successfully.
  
  Explanation
  The attempt by CICS to execute the health checks for the CICS
  Region Configuration has not completed successfully.
  
  Operator response
  Report this exception to the system programmer.
  
  System programmer response
  This message indicates that one or more of the checks in the
  CICS Region Configuration suite of tests has failed to complete
  properly. Look to see if there are any useful messages in the
  CICS joblog which could identify the cause of the problem. If it
  is not possible to identify the problem, it will be necessary to
  contact IBM for assistance.
  
  2. DFHHCC5 related changes
  
  2.1 New message DFHH0506
  
  DFHH0506 The health check did not complete successfully.
  
  Explanation
  The attempt by CICS to execute the health checks for the CICS
  Resource Configuration has not completed successfully.
  
  Operator response
  Report this exception to the system programmer.
  
  System programmer response
  This message indicates that one or more of the checks in the
  CICS Resource Configuration suite of tests has failed to
  complete properly.
  Look to see if there are any useful messages in the CICS joblog
  which could identify the cause of the problem. If it is not
  possible to identify the problem, it will be necessary to
  contact IBM for assistance.
  
  3. DFHHCC6 related changes
  
  3.1 New message DFHH0604
  
  DFHH0604 The health check did not complete successfully.
  
  Explanation
  The attempt by CICS to execute the health checks for the CICS
  USS configuration has not completed successfully.
  
  Operator response
  Report this exception to the system programmer.
  
  System programmer response
  This message indicates that one or more of the checks in the
  CICS USS configuration suite of tests has failed to complete
  properly.
  Look to see if there are any useful messages in the CICS joblog
  which could identify the cause of the problem. If it is not
  possible to identify the problem, it will be necessary to
  contact IBM for assistance.
  
  4. DFHHCC7 related changes
  
  4.1 New message DFHH0709
  
  DFHH0709 The health check did not complete successfully.
  
  Explanation
  The attempt by CICS to execute the health checks for CICS
  Resource Security has not completed successfully.
  
  Operator response
  Report this exception to the system programmer.
  
  System programmer response
  This message indicates that one or more of the checks in the
  CICS Resource Security suite of tests has failed to complete
  properly.
  Look to see if there are any useful messages in the CICS joblog
  which could identify the cause of the problem. If it is not
  possible to identify the problem, it will be necessary to
  contact IBM for assistance.
  
  5. DFHHCC8 related changes
  5.1 New message DFHH0811
  
  DFHH0811 The health check did not complete successfully.
  
  Explanation
  The attempt by CICS to execute the health checks for CICS
  Category 3 Transactions has not completed successfully.
  
  Operator response
  Report this exception to the system programmer.
  
  System programmer response
  This message indicates that one or more of the checks in the
  CICS Category 3 Transactions suite of tests has failed to
  complete properly.
  Look to see if there are any useful messages in the CICS joblog
  which could identify the cause of the problem. If it is not
  possible to identify the problem, it will be necessary to
  contact IBM for assistance.
  

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:

  UI95992

Modules/Macros

• DFHHCC4  DFHHCC5  DFHHCC6  DFHHCC7  DFHHCC8  DFHHCCHK DFHHZMSG
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI95992

     UP24/03/12 P F403

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.