OA17167: "UNEXPECTED CHANGES..." ERROR OCCUR (KXCRC_UNKNOWN_OBJECT PROBLEM)

APAR status

• Closed as program error.

Error description

• While accessing LDAP data, KXCRC_UNKNOWN_OBJECT error occurs
  with suberror KXMRC_UNEXPECTED_CHANGES: Unexpected changes in
  Roma configuration.
  

Local fix

• 1) LDAP cache refresh can be disabled by setting KXCCTIME
  environment variable to a big value.
  For example, 864000 will disable LDAP cache refresh for 10 days
  and the problem will not happen 10 days.
  
  2) Use LDIF as a backup if CASP can't connect LDAP for some
  reason. LDAP content can be exported into LDIF and LDIF URL
  added to the KXCDIR, for example:
  
  KXCDIR=ldap://hoc08wuw05:389/cn=RomaContext,dc=Context,dc=Roma,d
  c=candle
  ,dc=com;file:////mydir/my.ldif
  

Problem summary

• When CASP needs some LDAP data, cannot find it in the LDAP
  cache, trys to refresh the cache, and the LDAP server is
  unavailable at that time, KXCRC_UNKNOWN_OBJECT error occurs with
  suberror KXMRC_UNEXPECTED_CHANGES: Unexpected changes in Roma
  configuration.
  

Problem conclusion

• Added reconnection logic to some functions accessing LDAP
  server, new constants LDAP_SEND_ERROR and LDAP_RECV_ERROR for
  clearer identification of LDAP server connection errors,
  improved handling of LDAP server connection errors.
  
  If KXM ILS LDAP cache cannot contact the LDAP server, error
  KXCRC_LDAP_SEARCH_FAILURE is raised instead of
  KXMRC_UNEXPECTED_CHANGES to describe the situation more clear.
  

Temporary fix

Comments

• The fix for this APAR is contained in the following maintenance
  packages:
  for KXS module - 1.0.0.3-TIV-ASPK-IF0003
  for KXC and KXM modules - 1.0.0-TIV-ASPK-FP0003
  

APAR Information

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

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

Fix information

• Fixed component name

  CASP DIRECTORY

• Fixed component ID

  5608A5202

Applicable component levels

• R310 PSN

     UP