PM53962: Record will remain locked if action initialize hook fails when using pessimistic record locking

Rational ClearQuest Fix Pack 06 (8.0.0.6) for 8.0
Rational ClearQuest Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearQuest Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearQuest Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearQuest Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearQuest Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearQuest Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearQuest Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearQuest Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearQuest Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearQuest Fix Pack 21 (8.0.0.21) for 8.0

APAR status

• Closed as program error.

Error description

• Record lock is unlocked when an action is committed or reverted,
  however, if action initialize hook fails, the record will not be
  unlocked. If action validation or commit hook fails for some
  reason, a user needs to click 'Revert'. If action initialize
  hook fails, a record form is not editable and you cannot revert
  it.
  
  How to reproduce it:
  1. Check out DefectTracking schema. Change language to PERL.
  2. Add a new BASE action named LockRecord to Defect record type.
  3. Add an Initialization hook in PERL to the action.
  4. Add the following line.
     $entity-?LockRecord (0);
  5. Add action initialize hook to Modify action.
  6. Add the following code:
      $username = $session-?GetUserLoginName();
      if ( $username eq 'user' ) {
       die('User cannot modify the record');
  
   }
  
  7. Create a user database and login as user.
  8. Create a record and modify it.
  9. You will get the error 'User cannot modify the record' and
  the record will stay locked.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  ClearQuest record locks are supposed to be released when an
  action is committed or reverted, however, if an action
  initialization hook fails, the record will not be unlocked.
   If the hook fails for some reason, a user is not allowed to
  click "Revert", because the record form is not editable.
  

Problem conclusion

• A fix is available in ClearQuest 8.0.0.6.
  
  The CQ record will no longer stay locked if the action
  initialization hook fails.
  

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:

Fix information

• Fixed component name

  CLEARQUEST WIN

• Fixed component ID

  5724G3600

Applicable component levels

• R712 PSN

     UP