Building and Deploying the Error-Handling Projects

These procedures build and deploy Deployment Profiles that map the resources named in the cmSub_DLQ and cmSub_ProcErrors Connectivity Maps to the externals in an Environment. The cmSub_DLQ map uses a BP to receive messages from the JMS topic EX_DEADLETTER (sometimes called the “dead letter queue”) and write them to a file. The cmSub_ProcErrors map uses a BP to receive messages from the JMS topic EX_PROCESSEDERRORS and write them to a file.

Before you begin

1. With the Project Explorer tab active, in the project tree, open the eXchange⇒Errors project.

2. If you have not already done so, start the domain associated with the Environment’s Integration Server.

To build and deploy the Deployment Profile for the Sub_DLQ Project

1. In the project tree, under eXchange⇒Errors⇒Sub_DLQ, open cmSub_DLQ and make sure that its File eWay is configured appropriately for your operating environment.

2. Right-click the Sub_DLQ project.

3. On the context menu, point to New and click Deployment Profile

4. In the Create Deployment Profile dialog box, name the Deployment Profile to dpErrorsDLQ and point it at the correct Environment.

5. Make sure that it is referencing cmSub_DLQ (the Connectivity Map for the “dead letter” topic), and then click OK.

   See Figure 4–25.

   Figure 4–25 Deployment Profile for Sub_DLQ Project

   
   

6. In the Deployment Editor, click Automap to map the two components to their respective external systems, and then click Build.

   See Figure 4–26.

   Figure 4–26 Deployment Profile dpErrorsDLQ Being Built

   
   

7. After the build step completes successfully (creating the EAR file), click Deploy.

   The Sub_DLQ project is built and deployed. At runtime, any undeliverable messages that cannot be processed are copied and written to a file.

To build and deploy the Deployment Profile for the Sub_ProcErrors Project

1. In the project tree, under eXchange⇒Errors⇒Sub_ProcErrors, open cmSub_ProcErrors and make sure that its File eWay is configured appropriately for your operating environment.

2. Right-click the Sub_ProcErrors project.

3. On the context menu, point to New and click Deployment Profile.

4. In the Create Deployment Profile dialog box, name the Deployment Profile to dpErrorsProc and point it at the correct Environment.

5. Make sure that it is referencing cmSub_ProcErrors (the Connectivity Map for the “processed errors” topic), and then click OK.

6. In the Deployment Editor, click Automap to map the two components to their respective external systems, and then click Build.

7. After the build step completes successfully (creating the EAR file), click Deploy.

   See Figure 4–27.

   Figure 4–27 Deployment Profile dpErrorsProc Being Deployed

   
   

   The Sub_ProcErrors project is built and deployed. At runtime, undeliverable messages written to the processed-errors topic are copied and written to a file.