PH35148: CICS ISSUES MESSAGE DFHPA1951I FOR BOTH A MISSING REGION FEATURE TOGGLE FILE AND A COMMON FEATURE TOGGLE FILE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When either the region specific feature toggle file or the
  common feature toggle file is missing, the following message is
  issued:
  DFHPA1951I applid FEATURE TOGGLE FILE COULD NOT BE
  FOUND: path
  This message will be changed so that it is issued
  only for a missing common feature toggle file. A new and
  different message will be issued to indicate that a region
  specific toggle is missing.
  Additional Keywords: KIXREVACC
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS does not differentiate error       *
  *                      reporting for missing common or         *
  *                      region level USSCONFIG                  *
  *                      featuretoggles.properties files.        *
  ****************************************************************
  During CICS startup, DFHPAFT tries to reference both the
  common and the region level featuretoggles.properties files,
  as located through the USSCONFIG path structure. If either such
  file cannot be found, CICS issues message DFHPA1951. There is
  no way to differentiate which of the two file types may be
  missing. In addition, longer USSCONFIG path names can result in
  DFHPA1951 being issued across several lines. Since DFHPAFT uses
  individual WTOs to write each line, these are not associated
  together with WTO continuation numbers. This can affect jobs
  that validate the CICS startup messages, as the lines are not
  being treated as part of one multi-line message, and so not
  validated as such.
  KEYWORDS: msgdfhpa1959 pa1959 1959 msgdfhpa1951 pa1951 1951
  

Problem conclusion

• DFHPAFT has been changed to issue DFHPA1951 if a common
  featuretoggles.properties file is not found, and new message
  DFHPA1959 if a region level featuretoggles.properties file is
  not found. In addition, multi-line WTO support is now used to
  issue the messages.
    The CICS Messages manual will be updated as follows.
  Existing message DFHPA1951 will be replaced, and new message
  DFHPA1959 added, as follows:
  .
  DFHPA1951I applid COMMON FEATURE TOGGLE FILE COULD NOT BE
  FOUND: path
  Explanation
  A CICS common feature toggle file could not be found at the
  specified path. CICS initialization continues.
  System action
  CICS startup continues.
  User response
  As a minimum an empty featuretoggle.properties file
  should be created in the directory with the correct
  permissions in place to enable it to be opened. If
  feature toggles are required, add the feature toggles to
  the required file.
  Module:
  DFHPAFT
  XMEOUT parameters/Message inserts
  1. applid
  2. path
  Destination
  Console
  
  .
  DFHPA1959I applid REGION FEATURE TOGGLE FILE COULD NOT BE
  FOUND: path
  Explanation
  A CICS region level feature toggle file could not be found at
  the specified path. CICS initialization continues.
  System action
  CICS startup continues.
  User response
  As a minimum an empty featuretoggle.properties file
  should be created in the directory with the correct
  permissions in place to enable it to be opened. If
  feature toggles are required, add the feature toggles to
  the required file.
  Module:
  DFHPAFT
  XMEOUT parameters/Message inserts
  1. applid
  2. path
  Destination
  Console
  

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:

  UI75858

Modules/Macros

• DFHMEPAC DFHMEPAE DFHMEPAK DFHPAFT
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R300 PSY UI75858

     UP21/06/15 P F106

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.