IBM Support

PM55089: DXL Docs: getLocksInDatabase perm not clear

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Part of the explanation for the getLocksInDatabase perm in the
    DXL Reference Manual says:
    'If allUsers is false, or missing, the list contains only locks
    held by the current user. Locks on items that the user currently
    has open are not included in this list.'
    
    This seems to be contradictory. Furthermore there is an example
    which does not seem to yield any results...
    
    Lock lockItem
    string username
    LockList lcklist = getLocksInDatabase
    for lockItem in lcklist do {
        username = lockItem.user
        print username '\n'
    }
    
    Results are only printed if you change the third line to say:
    LockList lcklist = getLocksInDatabase (true)
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Part of the explanation for the getLocksInDatabase perm in
    the DXL Reference Manual says:
    "If allUsers is false, or missing, the list contains only
    locks held by the current user. Locks on items that the user
    currently has open are not included in this list."
    
    This seems to be contradictory. Furthermore there is an
    example which does not seem to yield any results...
    
    Lock lockItem
    string username
    LockList lcklist = getLocksInDatabase
    for lockItem in lcklist do {
        username = lockItem.user
        print username "\n"
    }
    
    Results are only printed if you change the third line to
    say:
    LockList lcklist = getLocksInDatabase (true)
    

Problem conclusion

  • The DOORS DXL Manual has been updated to reflect the correct
    behaviour.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM55089

  • Reported component name

    TLOGIC DOORS

  • Reported component ID

    5724V61DR

  • Reported release

    930

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-12-28

  • Closed date

    2012-09-05

  • Last modified date

    2012-09-05

  • 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

    TLOGIC DOORS

  • Fixed component ID

    5724V61DR

Applicable component levels

  • R930 PSN

       UP



Document information

More support for: Rational DOORS

Software version: 9.3

Reference #: PM55089

Modified date: 05 September 2012