PI87251: IRPCLASS.ADDRECEPTION INCORRECTLY THROWS RHAPSODYRUNTIMEEXCEPTION WHEN EVENT BELONGS TO A READ ONLY PACKAGE.

IBM Rational Rhapsody 8.3.0

APAR status

• Closed as program error.

Error description

• If you manually add a reception to a class for an event that
  belongs to a read only package, the reception is successfully
  added to the class, the event shows a reference to the reception
  and the class's package (write enabled) sbs file stores the
  actual reference.
  
  However, if you try to do this with the API method
  IRPClass.addReception, the event's package is incorrectly
  checked and the process throws an exception because the package
  is read only. However, the API should not check the event
  package for write permissions as the reference does not need to
  be added to that file.
  
  I have monitored the unit files during the manual operation and
  no changes are made to the event's package file. So having this
  file as read only should not block the API.
  
  
  Workaround:
  
  check if the new reception name exists in the model as an event,
  get the package of the event, change to read enabled, add the
  reception to the original selected class.
  
  For example,
  
  IRPClass aClass = (IRPClass)app.getSelectedElement();
  IRPEvent targetEvent =
  (IRPEvent)app.activeProject().findNestedElementRecursive(newEven
  tName, "Event");
  
  IRPPackage parent = (IRPPackage)targetEvent.getOwner();
  if (parent.isReadOnly() == 1) {
      parent.setReadOnly(0);
      aClass.addReception(newEventName);
  }
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Rhapsody                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * IRPClass.addReception incorrectly throws                     *
  * RhapsodyRuntimeException when event belongs to a read only   *
  * package.                                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Fixed by fixing the check if the reception can be added.
  

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 RHAPSODY

• Fixed component ID

  5724V74RP

Applicable component levels

• R815 PSY

     UP