IBM Support

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

Subscribe

You can track all active APARs for this component.

 

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 number

    PM53962

  • Reported component name

    CLEARQUEST WIN

  • Reported component ID

    5724G3600

  • Reported release

    712

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-12-09

  • Closed date

    2013-03-20

  • Last modified date

    2013-03-20

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1.2","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
20 March 2013