public void setReferences (String attributeName, ObjectReference [] refs)
throws InvalidParameterException

This method sets references of the business object or notification. Note that if the updateEntity method of the IExecutionEngine interface is used to update the business object in the database after setting its references the system will delete any existing references of the business object and add whatever references are set by the setReferences method. If, however, the setReferences method sets the value to null and then the updateEntity method is called, the null value is interpreted by the system as “no change” so no existing references are deleted. To clear existing references use the deleteReferences method in the IExecutionEngine interface.