PM55089: DXL Docs: getLocksInDatabase perm not clear

Rational DOORS Fix Pack 1 (9.4.0.1) for 9.4

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 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