getInitiator()

Retrieves the calling context associated with the current map instance.

Syntax

String getInitiator()
 

Parameters

None.

Return values

Returns a static constant variable representing the calling context for the execution of the current map instance. Calling contexts are one of the following values:

EVENT_DELIVERY
The source business objects being mapped are sent from an application to InterChange Server Express through a connector.

ACCESS_REQUEST
The source objects being mapped are sent from an application to InterChange Server Express through an access client.

SERVICE_CALL_REQUEST
The source objects being mapped are sent from InterChange Server Express to an application through a connector.

SERVICE_CALL_RESPONSE
The source objects being mapped are sent back to InterChange Server Express from an application through a connector after a successful service call request.

SERVICE_CALL_FAILURE
The source objects being mapped are sent back to InterChange Server Express from an application through a connector after a failed service call request.

ACCESS_RESPONSE
The source objects being mapped are sent back from InterChange Server Express to the application through an access client.

Exceptions

None.

Notes

The calling context is part of the map execution context. For more information on how calling contexts are used in maps, see "Understanding map execution contexts".

Examples

In the following example, compare the map run-time initiator with the constants defined in the MapExeContext class:

String sInitiator = null; 
 sInitiator = cwMapCtx.getInitiator();
 if(sInitiator.equals(MapExeContext.EVENT_DELIVERY))
      logInfo("**************Initiator =  MapExeContext.EVENT_DELIVERY.");
 

See also

getOriginalRequestBO(), setInitiator()

Copyright IBM Corp. 1997, 2003