TI 如何允许 TP 返回异常

TI 提供了一种元数据机制,用于从自动化服务器应用程序(如 TI 应用程序)返回异常。 TI 使用此机制为大型机开发人员提供一种可选的方法来返回大型机错误信息, (也称为异常数据,) 正常应用程序返回。

(TP) 事务程序将错误信息作为可选元数据返回,其中包括异常块作为回复消息的一部分。 异常块包含可用于填充自动化异常结构的标准格式的信息。

TI 错误消息的数字范围为 0-9999。 从大型机返回的元数据错误消息编号可能位于同一范围内。 为了区分 TI 错误消息和从大型机返回的元数据消息,TI 向从大型机返回的任何元数据错误消息的数量添加 10000。

TP 还可以使用此机制向 TI 运行时环境提供有关 TP 状态的信息。 具体而言,TP 可以指示 TP 是否:

  • 愿意提交到目前为止 (执行的工作,并解除分配对话) 。

  • 不能对当前会话执行更多工作,并且需要客户端准备和提交。

  • 遇到将阻止它提交事务的错误。

    虽然 TP 始终可以突然解除分配会话,但 TI 异常允许它向调用客户端应用程序返回有关错误的详细信息。

    TI 使用异常块中包含的信息更新 TI 运行时环境中的状态信息,如果请求 (,) 将异常返回给客户端应用程序。

    下表显示了 EXCEPINFO 异常结构中的字段。

字段 说明
wCode 异常块中返回的错误代码。
bstrSource TI 根据有关客户对象和远程 TP 的信息自动生成。
bstrDescription 从异常块。 此错误说明来自远程 TP。
bstrHelpFile 采用注册表) 中与对象的组件库关联的帮助路径 (,并将其与组件库中作为自定义信息包含的不限定文件名组合在一起。 这样,开发人员就可以在创建帮助文件时标识帮助文件的文件名,同时让管理员最终控制帮助文件在部署期间安装的位置。
dwHelpContext 从异常。
scode wCode 相同。

TP 可以在不实际引发异常的情况下返回状态信息。 为了让大型机 TP 代码尽可能简单,异常数据是可选元数据的一部分,无论是否发生错误,都会在所有情况下返回。

另请参阅

WIP 的功能