通过

方法属性

  • 项目

使用 “方法 属性”页可以设置方法上的数组、COBOL、设计、主机定义和记录集属性。

数组属性

使用此选项 要执行此操作
数组维度 选择返回值的数组维度。 默认值为 (无) 。
是数组 选择返回值是否为数组。 可能的值为：

- 真
- false (默认)
发生取决于 选择 此项可指示自动化) 中表 (记录集或数组前面的数值数据项指示发送或接收的实际行数或元素数。 等效于 COBOL 中的可变长度表。

使用下拉列表选择指定此值的数值数据项。 对于 CICS Link，记录集或数组以及关联的长度说明符必须输入/输出。缓冲区中位于可变长度表后面的数据紧跟在表中最后一个数据项之后，而不考虑为表指定的最大大小。 具有多个维度的数组只能用于最外层的循环 (COBOL) 或最右边的维度 (Microsoft® Visual C++ ® 或 Visual Basic) 。 默认值为 (无) 。

COBOL 属性

使用此选项 要执行此操作
主机数据类型 选择主机数据类型。
错误处理 选择返回值错误处理。 可能的值为：

- 截断。 选择此选项可将 TI 设置为在发生错误时截断值。 （默认值）
- 舍入。 选择此选项可将 TI 设置为在发生错误时对值进行舍入。
- 错误。 选择此选项可将 TI 设置为在发生错误时返回错误。
填充符 键入返回值填充符。 默认值为 0。
从主机 键入从服务器接收的缓冲区中此数据项之后的 FILLER 字节数。 FILLER 会导致缓冲区中出现未翻译的间隙。 填充在自动化端不可见。 默认值为 0。
到主机 键入发送到服务器的缓冲区中此数据项之后的填充字节数。 FILLER 会导致缓冲区中出现未翻译的间隙。 填充在自动化端不可见。 默认值为 0。
缩放 键入返回值刻度。
Sign 属性 选择返回值符号属性。 可能的值为：

- 尾随。 对于带符号的 DISPLAY 数据类型，指示符号在默认) (尾随。 此选项向 TI 运行时环境指示带符号 DISPLAY 数据类型的格式，并影响主机中的数据与自动化数据类型的转换方式。
- 尾随分隔。 对于带符号的 DISPLAY 数据类型，指示符号是分开的。 此选项向 TI 运行时环境指示带符号 DISPLAY 数据类型的格式，并影响主机中的数据与自动化数据类型的转换方式。
- 前导。 对于带符号的 DISPLAY 数据类型，指示符号为前导。 此选项向 TI 运行时环境指示带符号 DISPLAY 数据类型的格式，并影响主机中的数据与自动化数据类型的转换方式。
- 前导分隔。 对于带符号的 DISPLAY 数据类型，指示符号是分开的。
大小 键入返回值大小。
SOSI 选择此选项可指定双字节字符集数据应以移出 (SO) 开头，以移入 (SI) 字符结束。 可能的值为：

- True。 SO 和 SI 字符在从主机应用程序接收数据时从数据中删除，SO 和 SI 字符在发送到主机应用程序时将添加到数据中。 在 PIC G 的长度中，不需要包含 SO 和 SI 字符的两个字节，因为 TI 运行时环境会应用它们。
- false (默认)
字符串分隔 选择返回值字符串分隔符。 可能的值为：

- 空格填充。 告知 TI 运行时环境，通过用空格字符填充字符串定义来分隔字符串的大型机表示形式。 例如，如果大型机的 COBOL 定义是 PIC X (10) 但字符串中只有三个字符，则大型机需要 7 个尾随空格。 因此，选择此选项会告知 TI 运行时环境转换发送到大型机的字符串，以将字符串的 NULL 终止字符更改为适当数量的尾随空格，然后再将其发送到大型机。 例如，如果在大型机上将字符串定义为 PIC X (10) ，则 TI 将发送 ABC 字符串，后跟 7 个尾随空格。 选择此选项还会告知 TI 运行时环境通过将字符串的尾随空格转换为单个 null 终止字符，将大型机返回的输出字符串转换为 TI 自动化服务器。 有关详细信息，请参阅 用空格填充大型机字符串。 （默认值）
- 以 Null 结尾。 告知 TI 运行时环境，字符串的大型机表示形式由空字符分隔， (EBCDIC 0x00) 。 选择此选项会告知 TI 运行时环境在将字符串发送到大型机之前，如果字节有空间，则向字符串末尾添加一个空字符，并告知 TI 运行时环境在从大型机接收字符串时遇到的第一个空字符处停止。 因此，通过选择此选项，你将告知 TI 保留来自大型机的输出字符串中的尾随空格，因为 TI 不会将尾随空格转换为单个 NULL 终止符。 有关详细信息，请参阅 用空格填充大型机字符串。

设计属性

使用此选项 要执行此操作
允许 32K 入/出 如果希望 TI 独立于输出 DFHCOMMAREA 处理输入 DFHCOMMAREA，请选择此选项。 TI 通常将输入 DFHCOMMAREA 和输出 DFHCOMMAREA 区域组合在一起。 合并区域不能超过 32 KB 的数据。 选择此选项后，TI 将独立于输出 DFHCOMMAREA 处理输入 DFHCOMMAREA。 每个输入和输出区域最多使用 32 KB 的数据。 更改此选项会影响当前选择的方法。 可能的值为：

- 真
- 错误 (默认) 注意： 可以在 Windows 发起的处理 (WIP) CICS 编程模型以及任何主机发起的处理 (HIP) 编程模型中，将此属性用作“使用链接编程模型”的附件。 注意： 仅当 Is Link 属性设置为 True 时，此属性才可用。
说明 键入方法的说明。 说明最多可包含 250 个 Unicode 字符。
帮助上下文 ID 键入与此方法关联的帮助上下文 ID。 ID 用于连接到此方法的帮助，并在调用此方法期间发生异常时返回。 默认值为 0。
包含上下文参数 选择客户端对象方法是否自动包含上下文。 可能的值为：

- True。 Visual Basic .NET 自动将上下文作为附加参数包含在 参数中。 如果在方法调用中不包含 COMTIContext 参数以及其他参数，Visual Basic .NET 将返回错误消息 “System.MissingMemberException”类型为“System.MissingMemberException”的未经处理的异常 microsoft.visualbasic.dll， 并通知你无法使用已写入的参数数调用该方法。 如果收到此消息，请验证 “包含上下文参数 ”是否作为参数包含在方法的参数列表中。
- False。 Visual Basic .NET 不会自动将上下文作为附加参数包含在 参数中。 如果将此属性设置为 False ，并将 COMTIContext 参数与其他参数一起包含在方法调用中，Visual Basic .NET 将返回错误消息 microsoft.visualbasic.dll“System.MissingMemberException”类型为“System.MissingMemberException”的未经处理的异常， 并通知你无法使用已编写的参数数调用该方法。 如果收到此消息，请从方法参数列表中删除 COMTIContext 参数。

默认值为 True。
初始缓冲区值 键入初始缓冲区值。 默认值为 NULL。
是链接 选择主机对象方法是否使用链接编程模型。 Windows 发起的处理 (WIP) 的可能值为：

- True。 使用链接模型。 链接编程模型只能与 CICS 链接协议一起使用。
- False。 请勿使用链接模型。

默认值为 False。

主机发起的处理 (HIP) 的可能值为：

- 是的。 使用链接模型。 链接编程模型可以与所有协议一起使用。
- 否。 请勿使用链接模型。
- 使用 32K In/Out 的链接。使用链接模型并设置 From Host 和 To Host 属性。

默认值为 No。
元数据 选择如何处理元数据。 可能的值为：

- (无) 。 默认情况下，不会向主机应用程序发送或接收任何特殊数据。 如果只想发送和接收方法的数据，请选择此选项按钮。
- 包括方法信息。 要发送到主机的此方法的名称以及参数数据。 方法名称作为缓冲区中的前 32 个字节发送。 如果多个方法调用转到同一事务，并且你想要将数据与不同的调用区分开来，则此选项非常有用。
- 包括所有信息。 可以使用方法数据发送和接收的所有元数据。 有关元数据格式的详细信息，请参阅“可选元数据”的说明。
名称 键入方法的名称。 名称最多可包含 250 个 Unicode 字符。 该名称必须与同一项目中的任何其他方法名称不同。 默认值为 null。
之后的位置返回值 键入从主机接收所选数据项后跟的自动化方法返回值。 此选项不会影响自动化端。 如果要指定为自动化返回值的数据项不是描述从主机接收的数据的数据声明中的第一个数据项字段，请使用此选项。
初步填充物 查看从主机接收或发送到主机的 FILLER 字节数。
从主机 键入从服务器接收的缓冲区中此数据项之后的 FILLER 字节数。 FILLER 会导致缓冲区中出现未翻译的间隙。 填充在自动化端不可见。
到主机 在发送到服务器的缓冲区中键入此数据项之后的 FILLER 字节数。 FILLER 会导致缓冲区中出现未翻译的间隙。 填充在自动化端不可见。
返回类型 选择返回值类型。 可能的值为：

- 无效
- 布尔
- 字节
- 日期
- 货币
- 十进制
- 整数
- 长
- 双
- 单
- 字符串
- 用户定义的类型
- 记录
- (无) (默认)
可变大小的最终字段 - 如果最后一个数据项是字符串，则选择此选项，以指示字符串的大小有所不同。 此选项还用于将数据表或记录集定义为边界或包含定义为参数上设置 的“最大出现次数 ”的所有行。
从主机 - 真
- false (默认)
到主机 - 真
- 错误 (默认)

主机定义属性

使用此选项 要执行此操作
链接到程序名称 (CICS LINK/DPL) 键入到程序的链接名称。
镜像事务 ID 如果要替代与此组件关联的远程环境的 镜像 TRANID (RE) ，请键入此方法使用的 镜像 TRANID。 将此框留空会导致使用远程环境说明中的镜像 TRANID。

TRANID 的长度最多可为四个字符。 可接受的字符为 A-Z a-z 0-9 $ @ # 。 / _ % &？ ! : |= , ; <>。

以 C 开头的事务名称是为 CICS 保留的，不应使用。 如果事务安全性处于活动状态，则 % 和 & 字符可能会导致资源访问控制设施 (RACF) 出现问题。
TP 名称 当 CICS 应用程序必须访问 DB2 数据库时， (TP) 名称键入源事务程序。 TP 名称在 CICS 资源控制表 (RCT) 条目中引用，该条目将 CICS 事务与 DB2 计划相关联。

指定 (IMS 或 CICS) 的主机事务程序的名称，或 (CICS LINK/DPL) (程序名称。

记录集属性

使用此选项 要执行此操作
包括实际大小 主机程序不会包含或期望任何指示 (记录集的实际行数的信息，) 或 (数组) 发送或接收的元素。 可能的值为：

- 真
- 错误 (默认)

此属性是只读的，并且始终设置为 False ，除非在使用第一个版本的 COM 事务集成器创建类型库时将其设置为 True 。
最大出现次数 最大行出现次数。 指示要发送到主机或从主机接收的最大行数。 等效于 COBOL 组项上的 OCCURS n TIMES 关键字 (keyword) 。 默认值为 1。
发生时间取决于 等效于 COBOL 中的可变长度表。 指示自动化) 中表 (记录集或数组前的数字数据项指示发送或接收的实际行数或元素数。 使用下拉列表选择指定此值的数字数据项。 对于 CICS 链接，记录集或数组以及关联的长度说明符必须输入/输出。缓冲区中位于可变长度表后面的数据紧跟在表的最后一个数据项之后，而不考虑为表指定的最大大小。 对于具有多个维度的数组，它只能用于最外层的循环 (COBOL) 或最右侧的维度 (Visual C++ 或 Visual Basic) 。 返回值记录集的发生取决于 。 默认值为 (无) 。
无限 指示记录集未绑定。 指示可以向主机发送或从主机接收任意数量的行。 如果发送或接收的行来自数据库，并且最大行数未知，则可以选择此选项。 可能的值为：

- True。 当最后一个数据项是字符串时，这意味着字符串的大小会有所不同。
- False。 当最后一个数据项是数组时，这意味着数组中的元素数会有所不同。 当最后一个数据项是记录集时，这意味着记录集中的行数会有所不同。 （默认值）

注意

组件的属性不应以编程方式设置或更改。 以编程方式设置或更改属性可能会导致组件无法正常运行。

另请参阅

用 COMTIContext 自定义 TRM 和 ELM
方法名称节点 (.NET)
属性（TI 项目）