适配器开发工具箱用户指南

准备和运行

仅对 Windows 测试了 TwineBall 服务器、适配器和 ODA。它们可能在其它平台上工作,但对它们进行测试是一项留给用户的练习。

要运行 TwineBall 样本,必须已安装 JDK(最好是 1.3.1)。

设置数据库

为了演示创建、复原、更新和删除(CRUD)操作和真实的元数据驱动的设计,TwineBall 服务器使用实际的数据库来定义其实体和存储其数据。这需要进行某些附加设置。提供了一些脚本使设置变得容易,但是这些脚本将需要稍微修改以与您的系统相匹配。

要设置数据库,请遵循以下步骤。

  1. 安装 WebSphere Business Integration 适配器框架或 WebSphere InterChange Server 及其所有先决条件。
  2. 安装 IBM DB2 版本 8 修订包 2。
  3. 在操作系统中创建下列用户标识:

    TwineBall 和 TwineBallAdapter。

    为它们提供密码

    sample42
      
  4. 创建 Twine 数据库。在 setup/SQL 目录中,您将找到 Twine-database.bat 和 Twine-database.sql。
    编辑 Twine-database.sql 以将密码与 db2admin 标识相匹配。
  5. 运行 Twine-database.bat 脚本。您应该不会接收到任何错误消息。如果接收到错误消息,则解决它们后再继续。
  6. 创建 TwineBall 服务器所需的表。在 setup/SQL 目录中,您将找到 TwineBall-Schema.bat 和 TwineBall-Schema.SQL。
  7. 运行 TwineBall-Schema.bat 脚本。解决任何错误后再继续。
  8. 设置事件和归档表。在 setup/SQL 目录中,您将找到 WBIA-Events.sql 和 WBIA-Events.bat。
  9. 运行 WBIA-Events.bat 脚本。解决任何错误后再继续。

运行服务器

要运行服务器,请遵循以下步骤。

  1. 通过将所有 Java 源导入 IDE 的项目中,编译 /srcJNI_Supplement 目录中的整个 Java 源树。

    配置 IDE 以将 InterChange Server 或“适配器框架”的 /lib 目录中的所有 JAR 文件放在 CLASSPATH 中。

  2. 在“适配器框架”或 InterChange Server 安装的 connectors 目录下创建称为 TwineBall 的目录。
  3. 使用正常 Java 包结构(即,com.ibm.sample.MyClass 存储为 com/ibm/sample/Myclass.class)将所有已编译的类文件导出至此目录。
  4. 而且,将 setup\scripts 目录中的所有文件复制到此文件夹中。应用程序通常将在与适配器不同的目录中,但用此方法构造目录将简化安装。
  5. 将新创建的 TwineBall 目录添加至系统 CLASSPATH 中。这将允许 Java 运行时查找服务器类。
  6. 确保 Java Development Kit bin 目录位于 CLASSPATH 中。运行 runrmic.bat 文件。这将产生 RMI 通信所需要的存根和框架。
  7. TwineBall 目录内创建称为 Properties 的新目录。
  8. 将 TwineBall.policy 和 TwineBall.db2.properties 文件从 dependencies 目录移至此目录并将 TwineBall.db2.properties 重命名为 TwineBall.properties。
  9. 编辑 TwineBall.properties 文件以将 server.name 更改为您的系统名称。例如,如果您的机器称为 JEFFB,则 server.name 将为 //JEFFB:2112/TwineBallServer
  10. 通过执行 runserver 脚本启动 TwineBall 服务器。当它运行时,将出现消息“Server ... has been registered”。
  11. 保留服务器在窗口中运行。ODA 和适配器将通过 RMI 连接至它。

启动 TwineBall 连接器

要启动 TwineBall 连接器,请遵循以下步骤。

  1. 在“适配器框架”或 InterChange Server 安装的 /connectors 目录内创建称为 TwineBall 的目录。
  2. 如果您未运行 WebSphere InterChange Server 或“适配器框架”,则将配置文件放在该目录中。
    如果正在运行 InterChange Server,则导入该配置。
  3. 创建对代理程序运行适配器所必需的 WebSphere MQ 队列。如果代理程序是 InterChange Server,则由于您可以使用 IDL 传输,因此这可能不必要。
  4. 启动“连接器配置器”并将 MessageFileName 标准属性更改为“TwineBallAdapter.txt”。
  5. 尝试使用启动适配器的常用语法来启动连接器。例如:
    start_TwineBall TwineBall WMQI  -c
      C:\IBM\WebSphereAdapters\connectors\TwineBall\TwineBall.cfg
      
  6. 要测试适配器,可在 InterChange Server 中设置传递(Pass-Through)协作,或在非 InterChange Server 方式下颠倒传递和服务调用队列。然而,这些过程不在本文档所讨论的范围内。

启动 TwineBall ODA

要启动 TwineBall ODA,请遵循以下步骤。

使用 JNI

可构建 Java 适配器并使用“Java 本机接口”(JNI)来调用 C++ API。有关详细信息,请参阅Java 本机接口(JNI)

Copyright IBM Corp. 1997, 2003