deleteMyChildren()

Removes the specified child instances to a parent/child relationship for an identity relationship belonging to the specified parent .

Syntax

void deleteMyChildren(String parentChildRelDefName, 
       String parentParticpntDefName, BusObj parentBusObj, 
       String childParticpntDefName, Object childBusObjList,
       CxExecutionContext map_ctx) 
  
 void deleteMyChildren(String parentChildRefDefName, 
       String parentParticpntDefName, BusObj parentBusObj,
       String childParticpntDefName, CxExecutionContext map_ctx)
 

Parameters

parentChildRelDefName
The name of the parent/child relationship definition.

parentParticpntDefName
The name of the participant definition that represents the parent business object in the parent/child relationship.

parentBusObj
The variable that contains the parent business object.

childParticpntDefName
The name of the participant definition that represents the child business object in the parent/child relationship.

childBusObjList
The variable that contains child business object or objects to be deleted from the relationship. This parameter can be either a single generic business object (BusObj) or an array of generic business objects (BusObjArray).

map_ctx
The map execution context. To pass the map execution context, use the cwExecCtx variable, which Map Designer Express defines for every map.

Return values

None.

Exceptions

RelationshipRuntimeException 
 

Notes

The deleteMyChildren() method deletes child instances from a parent/child parentChildRelDefName relationship definition. It supports the following forms:

This method is useful in a custom relationship involving a parent business object with a unique key. When a parent business object has removed child objects, use deleteMyChildren() to compare the after-image (in parentBusObj) with the before-image (information in the relationship tables) to determine which child objects in the after-image have been removed. For each child object, deleteMyChildren() removes the corresponding child instance from the relationship tables for the parent and child participants (parentParticpntDefName and childParticpntDefName, respectively).

The deleteMyChildren() method requires that a parent/child relationship be defined with Relationship Designer Express. For information on how to create this kind of relationship, see "Creating the parent/child relationship definition"..

See also

addMyChildren(), updateMyChildren()

"Managing child instances"

Copyright IBM Corp. 1997, 2003