Creating a ZIETrans EJB project

Follow these steps to create a ZIETrans EJB project:

  1. Start with a ZIETrans project, which will ultimately contain the EJB Access Beans. This is referred to as the target ZIETrans project.
  2. Click File > New > Project > ZIETrans > ZIETrans EJB Project. Be sure to put the ZIETrans EJB project in the same EAR as your ZIETrans target project. Define one host connection in the wizard.
  3. If you want to use Integration Objects that were created with Host Publisher Studio, import them into your project. Click File > Import, select Host Publisher IO, and complete the wizard. You do not need to define connections or record macros for these Integration Objects.
  4. Define the connections to any additional host machines from which you will extract data. Refer to Managing connections for information about defining connections.
  5. If any of your host connections require connect and disconnect macros, use the host terminal to record those macros. Then use the connection editor to update each affected connection to specify the names of the connect and disconnect macros that are used on that connection. Refer to Connection editor for information about recording connect and disconnect macros.
  6. If you have not already created Integration Objects, connect to the host applications from the ZIETrans EJB Project view and follow the instructions in Using Integration Objects to create Integration Objects.
  7. When your ZIETrans EJB project contains all the connections, macros, and Integration Objects you require, you are ready to export EJB Access Beans to your target ZIETrans project. To do this, right click any Integration Object in your EJB project in the ZIETrans EJB Project view and select Export EJB Access Bean to ZIETrans Project. You can then select the target ZIETrans project, and the Integration Objects for which you want EJB Access Beans created.
  8. Now you are ready to work with the EJB Access Beans that you have just created in the target ZIETrans project. The EJB Access Beans are in the source folder of the target ZIETrans project, in the IntegrationObject package, in files with a name pattern of io-name_Access.java. You can create ZIETrans business logic to drive an EJB Access Bean; the process is the same as driving an Integration Object from business logic, which is described in Adding business logic. You can use Eclipse capabilities to Insert Beans and Insert Results from Beans onto JSP pages. You cannot generate ZIETrans Model 1 or Struts Web pages directly from an EJB Access Bean.
  9. Assemble the projects into an enterprise archive (EAR file), as described in Preparing your ZIETrans project for use as an application. Deploy it to WebSphere Application Server.

You can also use the EJB Access Beans in Java code that you write yourself. See Programming with EJB Access Beans for information about using the EJB Access Beans in code that you write.

The EJB Access Beans are created based on the macro that was recorded and made into an Integration Object. If you modify the macro in such a way that it changes the signature of the Integration Object, and redeploy the ZIETrans EJB project, you must re-export the matching EJB Access Beans and modify the code or JSPs that use them.

Parent topic: Creating and using a ZIETrans EJB application