从命令行调用该调用存根生成器
您可以从命令行运行 COBOL 调用存根生成器。
开始之前
为 COBOL 调用存根生成器所生成的代码创建 Rational® Application Developer 项目。
创建调用存根生成器配置文件。确保 EclipseHome、WorkSpace 和 EclipseProjectName 必需属性的设置正确。
检查 COBOL 源文件的 PROCEDURE 语句。
关于此任务
要从命令行运行 COBOL 调用存根生成器,必须运行用于为 configFile 和 callStubPackage 必需参数指定值的命令。还可以为命令中的可选参数指定值。
用于运行 COBOL 调用存根生成器的命令必须使用以下语法:
java –jar COBOLCallStubGenerator.jar
{input cobol file}
-configFile configuration_file_name
-callStubPackage package_name
[-callStubClass class_name]
[-cobolModule COBOL_module]
[-workSpace path_name]
[-eclipseProjectName project_name]
[-build build_string]
[-mockPackage package_name]
[-mockClass class_name]
[-v | -verbose]
[-? | -h]
名称 | 缺省值 | 必需还是可选 | 描述 |
---|---|---|---|
configFile | 必需 | 指定调用存根生成器配置文件的名称。 | |
callStubPackage | 必需 | 指定程序包名以及要用于所生成的调用存根的已生成文件的文件路径。 | |
callStubClass | COBOL PROGRAM-ID | 可选 | 指定要用于所生成的调用存根的类名。 |
cobolModule | COBOL PROGRAM-ID | 可选 | 指定包含该 COBOL 程序的 COBOL 模块或 DLL 文件的名称。 |
workSpace | 可选 | 指定要用于创建 Java™ 数据绑定类的 Rational Application Developer 或 Eclipse 工作空间的根目录标准路径。 为 workSpace 指定的任何值将覆盖调用存根生成器配置文件中的 WorkSpace 值,该配置文件由 configFile 值标识。 |
|
eclipseProjectName | 可选 | 指定用于为所生成的 Java 类提供主目录的 Rational Application Developer 或 Eclipse 工作空间中项目的名称。 在运行调用存根生成器之前,该项目必须已经存在。 为 eclipseProjectName 指定的任何值将覆盖调用存根生成器配置文件中的 EclipseProjectName 值,该配置文件由 configFile 值标识。 |
|
build | Unknown Build | 可选 | 指定由用户分配的构建标识。 |
mockPackage | 可选 | 指定用于 mock 类的程序包的名称。 | |
mockClass | 可选 | 指定要用于 mock 测试装置的类的名称。 |
过程
结果
该命令将运行调用存根生成器。如果该命令成功,那么调用存根生成器会创建 COBOL 调用存根 Java 类。
运行该命令时,调用存根生成器会创建临时 Ant 构建文件 system_temp_directory/CSG.temp.xml,然后在无头 Eclipse 会话中运行该文件。在该命令运行之后,将删除该临时文件。
COBOL 参数和返回值的 Java 数据绑定类是由 J2C 数据绑定工具生成,此工具包含在 IBM® Rational Application Developer for WebSphere® Software V7.5 或更高版本的 Java EE 连接器工具中。调用存根生成器和 J2C 数据绑定工具在无头 Eclipse 会话中运行,该会话将作为单独的 Java 进程进行启动。
在运行 Ant 构建文件之前,Eclipse 的无头调用将先尝试获取工作空间锁定。如果 Rational Application Developer 会话目前对于工作空间处于活动状态,那么 Eclipse 将无法获取工作空间锁定并且该命令将失败。
下一步做什么
使用所生成的 COBOL 调用存根 Java 类。