生成 COBOL 调用存根

可以使用 COBOL 调用存根生成器来创建 Java™ 调用存根以调用 COBOL 程序。可以将该调用存根添加至基于 Java 的批处理应用程序。

开始之前

请参阅 COBOL 容器概述主题。

安装以下产品,它们是使用 COBOL 调用存根生成器所必需的:

  • IBM® Rational® Application Developer for WebSphere® Software V7.5 或更高版本,它提供 J2EE 连接器 (J2C) 工具
  • Java 运行时环境 (JRE) V1.6.0 或更高版本

要验证是否启用了 Java EE 连接器 (J2C) 工具,请启动 Rational Application Developer,选择 Java EE 透视图,然后选择文件 > 新建 > 其他。如果 J2C 向导可用,那么您可以创建 J2C 项目,此时系统将启用 J2C 工具。

如果 Rational Application Developer 安装没有 Java EE 连接器 (J2C) 工具,请使用 Installation Manager 来修改 Rational Application Developer 安装并安装 J2C 工具:

  1. 启动 Installation Manager。
  2. 在“修改软件包”页面上,选择 IBM Rational Application Developer for WebSphere 软件 > J2EE 连接器 (J2C) 工具 > 下一步
  3. 完成 J2C 工具的安装。

关于此任务

可以从命令行、Ant 任务或 Rational Application Developer 产品的图形界面运行 COBOL 调用存根生成器。

COBOL 调用存根生成器执行以下步骤:

  1. 解析 COBOL 源程序。
  2. 为调用存根生成 Java 代码以调用 COBOL 程序。
  3. 为 COBOL 程序使用的参数输入和返回值的数据绑定生成 Java 代码。系统假定源程序是 COBOL 编译器已解析并编译的有效 COBOL 程序。

COBOL 参数和返回值的 Java 数据绑定类是由 J2C 数据绑定工具生成的,此工具包含在 Rational Application Developer 产品的 Java EE 连接器工具中。从命令行运行 COBOL 调用存根生成器时,调用存根生成器和数据绑定工具在无头 Eclipse 会话中运行。无头 Eclipse 会话是作为单独的 Java 进程启动的。从图形界面运行 COBOL 调用存根生成器时,调用存根生成器和数据绑定工具在活动 Rational Application Developer 会话内运行。

过程

  1. 为所生成代码创建 Rational Application Developer 项目。
  2. 在 COBOL 源文件中检查 PROCEDURE 语句。
    PROCEDURE 语句必须列示在 COBOL 源文件中,而不是列示在源文件包括的副本中。如果调用存根生成器在 COBOL 源文件中找不到 PROCEDURE 语句,那么调用存根生成器失败并产生以下错误:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Unable to find PROCEDURE statement in file COBOL_source_file
    而且,PROCEDURE 语句的 USING 子句中不得包含重复参数名称。如果 USING 子句包含重复参数名称,那么调用存根生成器失败并产生以下错误:
     com.ibm.ws.batch.cobol.csgen.exceptions.COBOLParserException:
      Detected duplicate COBOLDataElement: parameter name
  3. 更新调用存根生成器配置文件。

    请参阅有关调用存根生成器配置文件的主题。

  4. 运行 COBOL 调用存根生成器。

    您可以通过以下三种方式运行该调用存根生成器:

    从命令行
    1. 创建用于调用该调用存根生成器的脚本。
    2. 运行该脚本。
      $ java –jar lib/COBOLCallStubGenerator.jar script_path/Sample01.cbl –configFile csg.properties –callStubPackage my.pkg

    请参阅有关从命令行调用该调用存根生成器的主题。

    从 Ant 程序
    1. 定义用于调用该调用存根生成器的 Ant 任务。
    2. 指定 Ant 构建文件(例如,随 COBOL 调用存根生成器提供的 CSG.xml 文件)以运行该调用存根生成器。
    3. 运行 Ant 构建文件。

    请参阅有关从 Ant 任务调用该调用存根生成器的主题。

    从 Rational Application Developer 图形界面
    1. 运行 > 外部工具 > 外部工具配置菜单中配置用于调用该调用存根生成器的 Ant 构建。
    2. 指定 Ant 构建文件(例如,CSG.xml)以运行该调用存根生成器。
    3. 运行 Ant 构建文件。

    请参阅有关从图形界面调用该调用存根生成器的主题。

结果

如果调用该调用存根生成器成功,那么该调用存根生成器会创建 Java 调用存根以调用 COBOL 程序。

对于无头 Rational Application Developer 调用,该调用存根生成器运行时可能会产生错误。从命令行或 Ant 任务运行该调用存根生成器会使用无头调用。请检查以下日志以诊断错误:
workspace_path/.metadata/.log
该日志确定该错误是否由基于 Eclipse 的工具的问题(例如,无头调用未启动)导致。
user_home/.eclipse/ibm.software.delivery.platform_7.5.0/configuration
每个无头调用都可能会在 configuration 目录中创建日志文件。如果这些日志文件已存在,那么它们可能会提供有关该错误的故障诊断信息。

下一步做什么

使用所生成的 Java 调用存根来调用 COBOL 程序。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tgrid_cobol_csg_generate
文件名:tgrid_cobol_csg_generate.html