maintainChildVerb()

Sets the child business object verb based on the map execution context and the verb of the parent business object.

Syntax

public static void maintainChildVerb (String relDefName,
       String appSpecificParticpntName, 
 String genericParticpntName, 
       BusObj appSpecificObj
 String appSpecificChildObj,
       BusObj genericObj
 String genericChildObj,
       CxExecutionContext map_ctx
 boolean to_Retrieve,
 boolean is_Composite)
 

Parameters

relDefName
The name of the identity relationship name that manages the child business object.

appSpecificParticpntName
The name of the application-specific participant definition.

genericParticpntName
The name of the generic participant definition.

appSpecificObj
The application-specific object that contains the child object.

appSpecificChildObj
The name of the application child business object.

genericObj
The generic business object to or from which the appSpecificObject is being mapped.

genericChildObj
The name of the generic child business object.

ctx
The execution context.

to_Retrieve
The flag for the SERVICE_CALL_RESPONSE logic. When the condition is true, update the verbs of the child business objects. If false, do nothing.

isComposite
The flag that indicates whether the child participant uses composite keys. If the condition is true, keys are used; if false, keys are not used.

Return values

None.

Exceptions

RelationshipRuntimeException--see the Notes section for more information on when this exception is thrown

ClassCastException

Notes

The maintainChildVerb() method performs the following validations on arguments that are passed in:

If any of these validations fails, maintainChildVerb() throws the RelationshipRuntimeException exception.

Once the arguments are validated, the action that maintainChildVerb() takes depends on the following information:

For more information on the actions that maintainChildVerb() takes, see "Determining the child verb setting". Table 84 through Table 87 provide the actions for each of the calling contexts.

You call this method in the transformation step for the child attribute of a parent object. This child object can participant in either

You usually use maintainChildVerb() to set the verb of a child object that participates in a composite identity relationship (maintainCompositeRelationship()). However, you can also call it to set the verb of a child object that participates in a simple identity relationship (maintainSimpleIdentityRelationship()).

Examples

For an example involving maintainChildVerb(), see "Customizing map rules for a composite identity relationship".

See also

maintainCompositeRelationship(), maintainSimpleIdentityRelationship()

"Setting the source child verb"

Copyright IBM Corp. 1997, 2003