创建调用存根生成器配置文件

您可以创建调用存根以识别 Rational® Application Developer 安装位置和控制 Java™ 数据绑定代码生成

开始之前

为 COBOL 调用存根生成器所生成的代码创建 Rational Application Developer 项目。

关于此任务

调用存根生成器配置文件包含用于识别 Rational Application Developer 安装位置和控制 Java 数据绑定代码生成的设置。配置文件位置由用于命令行调用的 -configFile 设置或用于 Ant 调用的 <csg> 标记中的 configFile 属性指定。

请确保配置文件中的 EclipseHome、WorkSpace 和 EclipseProjectName 必需设置对 Rational Application Developer 安装是正确的。

过程

  1. 打开编辑器并创建调用存根生成器配置文件。

    调用存根生成器配置文件可以具有任何名称。此信息中心内的 COBOL 调用存根生成器的示例使用 csg.properties 文件名称。

  2. 在配置文件中指定 COBOL 调用存根生成器设置。
    下表描述了调用存根生成器设置。
    表 1. 用于配置 COBOL 调用存根生成器的属性. 请使用这些属性来指定 Rational Application Developer 安装位置和控制 Java 数据绑定代码生成。
    名称 缺省值 必需还是可选 描述
    EclipseHome

    [Linux]/opt/IBM/SDP

    [Windows]C:/Program Files/IBM/SDP

    必需 指定根目录(即,Rational Application Developer 或 Eclipse 在文件系统中的安装位置)的标准路径。
    避免故障 避免故障: 在所有路径名中使用正斜杠 (/),或记得对反斜杠 (\\) 进行转义。gotcha
    WorkSpace   必需 指定要用于创建 Java 数据绑定类的 Rational Application Developer 或 Eclipse 工作空间的根目录标准路径。
    EclipseProjectName   必需 指定用于为所生成的 Java 类提供主目录的 Rational Application Developer 或 Eclipse 工作空间中项目的名称。

    在运行调用存根生成器之前,该项目必须已经存在。

    平台 Win32 可选 指定目标操作系统。受支持的值包括 Win32、AIX 和 z/OS。 该值区分大小写。
    CodePage ISO-8859-1 可选 指定 COBOL 数据的代码页。
    FloatingPointFormat IEEE 754   指定浮点的格式。受支持的值包括 IEEE 754 和 IBM Hexadecimal。
    ExternalDecimalSign ASCII 可选 指定外部十进制符号。受支持的值包括 ASCII、EBCDIC 和 EBCDIC Custom。
    Endian Little 可选 指定 COBOL 数据的字节存储次序。受支持的值包括 Little 和 Big。
    RemoteEndian Little 可选 指定 COBOL 数据的远程字节存储次序。受支持的值包括 Little 和 Big。
    Quote DOUBLE 可选 指定引号格式。受支持的值包括 DOUBLE 和 SINGLE。
    Trunc STD 可选 指定在 COBOL 移动或算术运算期间截断字段的方式。受支持的值包括 STD、BIN 和 OPT。
    Nsymbol DBCS 可选 指定在文字和 PICTURE 子句中使用 N 符号的方式,以指示是使用本地处理,还是使用 DBCS 处理。 受支持的值包括 DBCS 和 NATIONAL。
    OverwriteExistingClass True 可选 指定调用存根生成器是否覆盖输出目录中已经存在的同名类。 受支持的值包括 true 和 false。
    GenerationStyle 缺省 可选 指定生成样式。受支持的值包括 Default、Preserve case of names 和 Shorten names。
    详细 false 可选 指定是否设置用于进行调试的跟踪级别。受支持的值包括 true 和 false。
  3. 将配置文件保存至 Rational Application Developer 产品可以访问的位置。

示例

请参阅以下样本 csg.properties 调用存根生成器配置文件:

# Configuration file for COBOLCallStubGenerator
#####
# EclipseHome specifies the installation location of Rational Application Developer.
#
EclipseHome=full_path_to_Eclipse_directory
 
#####
# Workspace specifies the location of the Rational Application Developer workspace.
# If it does not exist, the COBOLCallStubGenerator creates the workspace.
#
WorkSpace=full_path_to_workspace_directory
 
######
# EclipseProjectName specifies the project in the workspace
# that will receive the generated call stubs and bindings.
#
EclipseProjectName=Eclipse_project_name

#####
#  The target operating system. The permitted options are: Win32, AIX and z/OS.
#
# PARAMETER - Required
# Platform=Win32
Platform=z/OS

#####
#  The target codepage.
#
# PARAMETER - Required
CodePage=IBM1047

#####
# The floating point format has only two possible values: 
#   IEEE 754
#   IBM Hexadecimal
#   The default is IEEE 54
#
# PARAMETER - Required
FloatingPointFormat=IBM Hexadecimal

# PARAMETER - Required
ExternalDecimalSign=EBCDIC

# PARAMETER - Required
Endian=Big

# PARAMETER - Required
RemoteEndian=Little

# PARAMETER - Required
Quote=DOUBLE

# PARAMETER - Required
Trunc=STD

# PARAMETER - Required
Nsymbol=DBCS

#####
# Possible values for overwriteExistingClass are true or false.
#
# PARAMETER - Required
OverwriteExistingClass=true

#####
# Possible values for GenerationStyle are:
#   Default, "Preserve case of names" or "Shorten names"
# Be sure to use quotes for values with space characters in them.
#
# PARAMETER
GenerationStyle=Default

#####
# Verbose sets the trace level to "debug".
# Values for Verbose are either true or false. 
#
# PARAMETER - Optional
Verbose=false

下一步做什么

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

在运行 COBOL 调用存根生成器时,请指定调用存根生成器配置文件名称的标准路径。对于命令行调用,请使用 -configFile 设置来指定文件名。对于 Ant 和图形界面调用,请使用 <csg> 任务中的 configFile 属性来指定文件名。


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



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