If you have not already done so, review Understanding Orchestration and Creating a Simple Orchestration.
You can create an On <client message name> event handler for each client message received from the client. This event handler tells the ePortal runtime software how to handle each message as it is received from the client.
If the ePortal runtime software receives a client message, and your orchestration does not have an On <client message name> event handler defined for the client message, ePortal does one of the following, depending on orchestration property settings:
Throws an UnorchestratedMessageException. Refer to Handling Exceptional or Abnormal Conditions.
Attempts to map the client message to a corresponding server message with the same name and forward the server message to the ClearPath application.
Conversely, an On <client message name> event handler should always provide a reply to the client. If a particular On <client message name> event handler ends without executing a ReplyToClient activity, ePortal does one of the following, depending on orchestration property settings:
Throws an UnorchestratedMessageException. Refer to Handling Exceptional or Abnormal Conditions.
Attempts to map the last server message received from the ClearPath application to a corresponding client message with the same name and forward that client message to the client.
The map and forward behavior is useful for cases where the client message and server message match one-to-one.
By default:
The MCP COBOL project type throws an UnorchestratedMessageException.
All other project types use the map and forward behavior.
To set the behavior to throw an UnorchestratedMessageException:
In the ePortal Message View window, click the Open Orchestration icon. The Orchestration.eporch tab is displayed.
In the Orchestration.eporch tab, click on the root of the orchestration.
In the Properties window, set AutoGeneratePages to False; set DefaultReceiveHandling to ThrowException; set DefaultReplyHandling to ThrowException.
To set the behavior to map and forward:
In the ePortal Message window, click the Open Orchestration icon. The Orchestration.eporch tab is displayed.
In the Orchestration.eporch tab, click on the root of the orchestration.
In the Properties window, set AutoGeneratePages to True; set DefaultReceiveHandling to MapAndForward; set DefaultReplyHandling to MapAndForward.
Refer to Orchestration Properties for more information.