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

您可以创建调用存根以识别 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 可选 指定目标操作系统。受支持的值包括 Win32AIXz/OS。 该值区分大小写。
    CodePage ISO-8859-1 可选 指定 COBOL 数据的代码页。
    FloatingPointFormat IEEE 754   指定浮点的格式。受支持的值包括 IEEE 754IBM Hexadecimal
    ExternalDecimalSign ASCII 可选 指定外部十进制符号。受支持的值包括 ASCIIEBCDICEBCDIC Custom
    Endian Little 可选 指定 COBOL 数据的字节存储次序。受支持的值包括 LittleBig
    RemoteEndian Little 可选 指定 COBOL 数据的远程字节存储次序。受支持的值包括 LittleBig
    Quote DOUBLE 可选 指定引号格式。受支持的值包括 DOUBLESINGLE
    Trunc STD 可选 指定在 COBOL 移动或算术运算期间截断字段的方式。受支持的值包括 STDBINOPT
    Nsymbol DBCS 可选 指定在文字和 PICTURE 子句中使用 N 符号的方式,以指示是使用本地处理,还是使用 DBCS 处理。 受支持的值包括 DBCSNATIONAL
    OverwriteExistingClass True 可选 指定调用存根生成器是否覆盖输出目录中已经存在的同名类。 受支持的值包括 truefalse
    GenerationStyle 缺省 可选 指定生成样式。受支持的值包括 DefaultPreserve case of namesShorten names
    详细 false 可选 指定是否设置用于进行调试的跟踪级别。受支持的值包括 truefalse
  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-nd-mp&topic=tgrid_cobol_csg_create_config
文件名:tgrid_cobol_csg_create_config.html