Setting Up the Examples


To successfully run the examples, you must perform the following tasks:

  1. Build the COM Components, as described in Task A.
  2. If you are using TIBCO Enterprise for JMS, start the JMS server, as described in Task B.
  3. Do one of the following:
    • Start TIBCO BusinessWorks with any one of the following files:
    • BWExample-adcom-JMS.zip, if you are using TIBCO Enterprise for JMS.

      BWExample-adcom-RV.zip, if you using TIBCO Rendezvous.

      For details, see Task C.

      OR

    • Generate an EAR file as described in Task D, and deploy the examples using TIBCO Administrator as described in Task E.
  4. Start the adapter as described in Task F.
  5. Execute the operations on the business objects. For details, see Task G.
Task A Build the COM Components
Task B Start TIBCO Enterprise for JMS
  1. At the command prompt, go to the <JMS_HOME>\bin directory.
  2. Run the following command to start the TIBCO Enterprise for JMS Server:
  3. tibjmsd.exe

Task C Start TIBCO BusinessWorks Using TIBCO Designer
  1. To start TIBCO BusinessWorks, click Start>Programs>Tibco>TIBCO Designer 5.2> Designer 5.2 and click New Empty Project.
  2. Click Project > Import Full Project. The Import Project dialog is displayed.
  3. Click the Zip Archive tab and browse to the zip archive you want to import. Select one of the following from the tibco\adapter\adcom\5.3\TEAKExamples\BusinessWorks folder:
    • BWExample-adcom-JMS.zip, if you are using TIBCO Enterprise for JMS.
    • BWExample-adcom-RV.zip, if you using TIBCO Rendezvous.
  4. Click OK to import the file. The Import Options dialog is displayed. Select Overwrite on name conflict and click Apply.
  5. Select Project>Export Full Project. The Export Project dialog is displayed. Click the Local Repository tab, and specify a dat file name and directory. Click OK.
    For the Sync operation to work correctly, you must save the local repository with the same name as the zip file, in the same directory.
  6. Click the Tester tab and click the Start testing viewed process button or press F9. The Select Processes to Load dialog box is displayed.
  7. Select the required TIBCO BusinessWorks process and click Start Selected. The TIBCO BusinessWorks process is started.
Task D Generate an EAR File
  1. Complete step 1 to step 4 of Task C.
  2. Click Sample in the project panel. The Sample (Enterprise Archive) configuration panel is displayed. You can specify a different folder or file name. Click Apply to save changes.
  3. Click Build Archive. The Enterprise Archive File has built correctly message is displayed.
Task E Deploy the Examples Using TIBCO Administrator

To deploy the example using TIBCO Administrator, you must generate an EAR file as described in Task D.

In TIBCO Administrator:

  1. Go to Application Management. Click New Application. Upload the EAR file created in the previous section and click OK. On the following screen, clear the Quick Configure check box and then click Save. The Configuration page is displayed.
  2. Click the top level application name in the Configuration page.
    1. Go to the Advanced tab and provide the values for User Name and Password if it is not already provided.
    2. Click Apply and Save. The Configuration page is displayed. Expand the top-level application.
    3. Click the adapter archive (COMAdapterService.aar) and click Add To Additional Machines.
    4. Select the machine and click OK. In the following screen, click Save. In the Configuration screen click Deploy. Click OK.

Once the deployment is complete, click Service Instances under the application. The adapter and TIBCO BusinessWorks is listed. Select both and click Start Selected, if it is not running. The adapter service and the TIBCO BusinessWorks processes are started.

Task F Start the Adapter
  1. Make sure that the repository URL and configuration URL properties are set in the adcomService.tra file.
    • The tibco.repourl property must point to the BWExample-adcom-RV.dat or to the BWExample-adcom-JMS.dat file. For example, if you have installed the adapter on the C: drive and are using BWExample-adcom-RV.dat, the tibco.repourl property should be set as follows:
    • C:/tibco/adapter/adcom/5.3/examples/TEAKExamples/BusinessWorks/
      BWExample-adcom-RV.dat 
      
    • The tibco.configurl property should point to the adapter instance:
    • COMAdapterService

  2. At the command prompt, go to the <ADCOM_HOME>\bin directory.
  3. Start the service component of the adapter using the BWExample-adcom-RV.dat file:

   adcomService

Task G Executing Operations for Business Objects
  1. Open Index.htm from the <ADCOM_HOME>\examples\TEAKExamples\BusinessWorks\Html directory. The TIBCO Adapter for COM Examples page is displayed. The top right panel displays the business objects, and the bottom-left panel displays the operations available for each business object.
  2. Select a business object and run the operations against it:

TIBCO Adapter™ for COM Examples Guide
Software Release 5.3, September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com