PH48365: CERTIFICATE LABEL GETS FOLDED TO UPPER CASE IN FILTERS FOR CPSM WUI OR EXPLORER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are attempting to filter your view of the TCPIPService
  entities you have in your CICSPlex. You use a filter on the
  CERTIFICATE field, and your filter includes both upper and
  lower case characters. CPSM is incorrectly folding the
  characters in that filter to upper case, so any certificates
  that include lower case characters will not match the
  filter.
  
  For example, you have a certificate labeled
  'MyCertificate'. If you filter on CERTIFICATE=M* CPSM will find
  it, but if you filter on CERTIFICATE=My* it will not, even
  though it should, because the lower case 'y' gets folded to
  upper case CERTIFICATE=MY* was actually used internally.
  

Local fix

• Only filter up to the first lower case character, or do not use
  a filter.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM Users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: Mixed case filters on the certificate   *
  *                      attribute of TCPIPService records       *
  *                      through the CPSM API, CMCI, CICSplex    *
  *                      Data Interface and WUI, does not return *
  *                      the correctly filtered records.         *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  These regions do not       *
  *                 need to be brought down and restarted at     *
  *                 the same time or in any specific order.      *
  ****************************************************************
  The string value for the certificate attribute used in filters
  is incorrectly folded to uppercase. This results in incorrect
  filtering based on this value, with records with mixed case
  certificate values matching the input filter string, not being
  correctly returned on get requests through one the CICSplex SM
  interfaces. This is due to this value incorrectly being defined
  as being uppercase.
  

Problem conclusion

• The attribute uppercase='no' has been added to the definition
  of CERTIFCATE in the TCPIPS (TCPIPSevice) resource table.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PH48225

• APAR is sysrouted TO one or more of the following:

  UI81875

Modules/Macros

• EYUA0103 EYUC0103 EYUE0103 EYUL0103 EYUP0103 EYUT0103 EYUY0103
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R40M PSY UI81875

     UP22/08/11 P F208

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.