Rational Developer for System z


课程 1.1:通过向模型添加定制操作和参数来定制 PDS RAM

本课程将简要指导您完成向 PDS RAM 添加 HowTo 定制操作及其四个参数:valuestring1string2option
通过向 CRA0VDEF 文件提供适当的信息来将这些参数和操作添加至 PDS RAM。有关本课程中涉及到的步骤的更多信息,请参阅 CARMA Developer's Guide, Chapter 4. Customizing a RAM API using the CAF
  1. 从列示您将需要对 RAM 的 API 扩展的操作开始。对于此样本,您将添加具有下列属性的定制操作 HowTo:
    • 名称:HowTo
    • 描述:提供一个实现具有扩展点的插件项目的示例
    • 操作标识:100
    • RAM 标识:00
    • 参数列表:value、string1、string2 和 option
    • 返回值列表:
    提示: 如果您正在使用已交付的没有进行定制的样本 PDS,那么操作标识和 RAM 标识的下列值应当正确;但是,如果您已经添加或者除去了 RAM、定制操作或参数,那么请检查以确保操作标识是下一个可用的操作标识,并且 RAM 标识对应于样本 PDS RAM。
  2. 在上面的 HowTo 定制操作描述中,列示了参数和返回值。在 RAM 中也必须定义每个这些参数和返回值。对于每个参数的描述为如下所示:
    • 名称:value
    • 描述:一位数值
    • 参数标识:000
    • RAM 标识:00
    • 类型:string
    • 长度:1
    • 是否为常量:
    • 缺省值:
    • 提示:请输入一位数值:
    • 名称:string1
    • 描述:文本字符串
    • 参数标识:001
    • RAM 标识:00
    • 类型:string
    • 长度:10
    • 是否为常量:
    • 缺省值:
    • 提示:请输入一个简短的文本字符串:
    • 名称:string2
    • 描述:文本字符串
    • 参数标识:002
    • RAM 标识:00
    • 类型:string
    • 长度:10
    • 是否为常量:
    • 缺省值:
    • 提示:请输入一个简短的文本字符串:
    • 名称:option
    • 描述:“是/否”选项
    • 参数标识:003
    • RAM 标识:00
    • 类型:string
    • 长度:1
    • 是否为常量:
    • 缺省值:
    • 提示:“是”还是“否”?
  3. 知道每个参数的操作、参数和描述将有助于您创建要包括在配置文件中的声明。每项操作及其参数都将在它自己单独的一行上定义,并且将在预定义的字节长度范围内指定其特定元数据。
    提示: 您还可以使用选项卡作为定界符来定义操作和参数,而不对元数据使用预定义的字节大小。要了解此备用格式的详细信息,请务必查阅 CARMA Developer's Guide, Chapter 4. Customizing a RAM API using the CAF

    对于此样本,将使用预定义的字节大小,定制 HowTo 操作被声明为:

    A00100  000,001,002,003|

    对于每个参数,声明为:

    P00000  STRING          1               N
    P00001  STRING          10              N
    P00002  STRING          10              N
    P00003  STRING          1               N
    注: 对于操作和参数,记录的前 8 个字节称为记录键。
  4. 请确保样本 PDS RAM、CARMA 和主机系统之间没有活动连接,然后才继续执行操作。
  5. 您应当将此信息添加至 FEK.SFEKVSM2(CRA0DEF),并确保所有记录键都采用字母数字顺序。对 REPRO FEK.SFEKVSM2(CRA0DEF) 使用位于 FEK.#CUST.JCL(CRA$VDEF) 处的 JCL 脚本。
  6. 接下来,对于您将在 CRA0VDEF 文件中定义的每项操作和每个参数,必须在 CRA0VSTR 文件中定义相应的定义,此文件中包含有关该操作或参数的任何与语言有关的信息。
    对于此样本,会在 CRA0VSTR 中将此定制操作定义为如下所示:
    EN_US   00037A00100  HowTo           仅用于演示。不执行任何操作。
    对于样本中的每个参数,其定义为:
    EN_US   00037P00000  value                           请输入一位数值。
    EN_US   00037P00001  string1                         请输入一个简短的文本字符串。
    EN_US   00037P00002  string2 	                       请输入一个简短的文本字符串。
    EN_US   00037P00003  option                          Y/N?
    注: 对于操作和参数,记录的前 21 个字节称为记录键。
  7. 您应当将此信息添加至 FEK.SFEKVSM2(CRA0VSTR) 文件,并确保所有记录都采用字母数字顺序。使用位于 FEK.#CUST.JCL(CRA$VSTR) 处的 JCL 脚本来 REPRO FEK.SFEKVSM2(CRA0VSTR)

参考


使用条款 | 反馈



本信息中心基于 Eclipse 技术。(http://www.eclipse.org)