本课程将简要指导您完成向 PDS RAM 添加 HowTo 定制操作及其四个参数:value、string1、string2 和 option。
通过向 CRA0VDEF 文件提供适当的信息来将这些参数和操作添加至 PDS RAM。有关本课程中涉及到的步骤的更多信息,请参阅 CARMA Developer's Guide, Chapter 4. Customizing a RAM API using the CAF。
- 从列示您将需要对 RAM 的 API 扩展的操作开始。对于此样本,您将添加具有下列属性的定制操作 HowTo:
- 名称:HowTo
- 描述:提供一个实现具有扩展点的插件项目的示例
- 操作标识:100
- RAM 标识:00
- 参数列表:value、string1、string2 和 option
- 返回值列表:
提示: 如果您正在使用已交付的没有进行定制的样本 PDS,那么操作标识和 RAM 标识的下列值应当正确;但是,如果您已经添加或者除去了 RAM、定制操作或参数,那么请检查以确保操作标识是下一个可用的操作标识,并且 RAM 标识对应于样本 PDS RAM。
- 在上面的 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
- 是否为常量:否
- 缺省值:无
- 提示:“是”还是“否”?
- 知道每个参数的操作、参数和描述将有助于您创建要包括在配置文件中的声明。每项操作及其参数都将在它自己单独的一行上定义,并且将在预定义的字节长度范围内指定其特定元数据。
提示: 您还可以使用选项卡作为定界符来定义操作和参数,而不对元数据使用预定义的字节大小。要了解此备用格式的详细信息,请务必查阅 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 个字节称为记录键。
- 请确保样本 PDS RAM、CARMA 和主机系统之间没有活动连接,然后才继续执行操作。
- 您应当将此信息添加至 FEK.SFEKVSM2(CRA0DEF),并确保所有记录键都采用字母数字顺序。对 REPRO FEK.SFEKVSM2(CRA0DEF) 使用位于 FEK.#CUST.JCL(CRA$VDEF) 处的 JCL 脚本。
- 接下来,对于您将在 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 个字节称为记录键。
- 您应当将此信息添加至 FEK.SFEKVSM2(CRA0VSTR) 文件,并确保所有记录都采用字母数字顺序。使用位于 FEK.#CUST.JCL(CRA$VSTR) 处的 JCL 脚本来 REPRO FEK.SFEKVSM2(CRA0VSTR)。