IC63425: CLIENT OPTION SET MAY NOT BE FOUND FOR NODE. THIS CAN RESULT IN OBJECT NOT BEING BOUND CORRECTLY IF INCLUDE STATEMENT IN CLOPSET

IBM Tivoli Storage Manager V6.1 Fix Pack 3 (6.1.3) Server Downloads

APAR status

• Closed as program error.

Error description

• Update node activity can lead to a deletion and re-insertion of
  the given node definition. If client backup process is occurring
  when this update node activity is processing a very small timing
  window exists where the node definition may not exist when the
  backup needs it to find the client options set. If this should
  occur the client will not receive the options defined for it on
  the server through this options set. Not receiving the client
  option set may lead to the client incorrectly processing the
  object it is working with. In the case of the reporting incident
  the include list with a management class specification was not
  being received by the client. This caused a backup object to be
  incorrectly bound to the wrong or unexpected management class.
  This can have retention and storage pool destination
  ramifications.
  
  Tivoli Storage Manager Versions Affected: 5.4, 5.5, 6.1
  Customer/L2 Diagnostics (If Applicable)
  In a failing case a server ADMIN trace will show that an option
  is not found:
  Option set not found trace points:
  ----------------------------------------------------------------
  [1328][admclqry.c][161]: Entry for admOpenOptSetQuery.
  [1328][admclqry.c][282]: admOpenOptSetQuery: return 0.
  ----------------------------------------------------------------
  
  Option set found trace points:
  ----------------------------------------------------------------
  [1387][admclqry.c][161]: Entry for admOpenOptSetQuery.
  [1387][admclqry.c][213]: admOpenOptSetQuery:Node found. Id=NN,
                           name=XXXXX.
  [1387][admclqry.c][230]: admOpenOptSetQuery:Found optset
                           name(YYYY)in table node.
  [1387][admutil.c][3838]: Acquiring lock (xLock) on optionset
                           YYYY.
  
  Initial Impact: Medium
  
  Additional Keywords: statement missing binding
  

Local fix

• Avoid performing any activity that would update any node
  attributes while a backup of that node is running.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Tivoli Storage Manager server users.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION.                  *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in levels 5.5.4 and 6.1.3. Note that this is *
  *                                                              *
  *                 subject to change at the discretion of IBM.  *
  ****************************************************************
  *
  

Problem conclusion

• This problem was fixed.
  Affected platforms:  AIX, HP-UX, Sun Solaris, Linux, z/OS, and
  Windows.
  

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:

  PK98995

Fix information

• Fixed component name

  TSM SERVER

• Fixed component ID

  5698ISMSV

Applicable component levels

• R55A PSY

     UP

• R55H PSY

     UP

• R55L PSY

     UP

• R55S PSY

     UP

• R55W PSY

     UP

• R55Z PSY

     UP

• R61A PSY

     UP

• R61H PSY

     UP

• R61L PSY

     UP

• R61S PSY

     UP

• R61W PSY

     UP

• R61Z PSY

     UP