“信息源”选项卡

使用信息源选项卡可定义此捕获规范从何处获取所发出的业务信息。

该选项卡包含您先前在事件绑定选项卡中定义的业务信息项的表格。 您必须为所发出的每个业务信息项输入信息源。

该选项卡用于将与事件规范关联的业务信息项映射到该捕获点的可用数据项。要映射项,请双击该项,这样会打开“编辑信息源”窗口。

“信息源”选项卡的图像。

信息源表中的字段是您可以在“编辑信息源”面板中编辑的选项的摘要。

应用程序捕获点的“编辑信息源”面板

突出显示该表中的某个信息源并单击编辑时,将打开“编辑信息源”面板。
图 1. 该图像显示了当为应用程序捕获点选择 REWRITE 时可能会显示的“信息源”面板。
应用程序捕获点的“编辑信息源”面板的图像。
编辑信息源”面板的“可用数据”窗格包含以下字段:
上下文
上下文字段用于捕获关于应用程序上下文的数据。有效的上下文选项包括:
PROGRAM
TRANSID
USERID
事件选项
事件选项用于捕获 CICS 命令上选项的值。事件选项因指定的捕获点而异。
应用程序数据
捕获规范中的谓词用于过滤 CICS 命令中指定的应用程序数据。 应用程序数据因指定的捕获点而异。“编辑信息源”面板右侧的副本导入和格式化选项仅当在“可用数据”窗格中选择了应用程序数据项时才可用。
根据您在“编辑信息源”面板的“可用数据”窗格中选择的选项,“编辑信息源”面板的剩余窗格中会提供以下字段:
容器
指定 CICS 通道容器。仅当应用程序数据指定了通道时才可以选择容器字段。在所有其他情况下,该字段都被禁用。

如果您希望导入语言结构,请单击 “从导入的语言结构中选择”按钮的图像。 按钮。然后,您可以从语言结构中选择要捕获的字段。 如果您使用该方法,那么将自动填写类型偏移量长度字段。 或者,您可以指定类型偏移量长度值。

类型
指定应用程序数据谓词的数据类型。有以下数据类型可用:
  • 二进制浮点
  • 字符
  • 以 null 结束的字符
  • 十进制浮点
  • 十六进制
  • 以 null 结束的十六进制
  • 十六进制浮点
  • 压缩十进制
  • 带符号半字
  • 带符号全字
  • 无符号半字
  • 无符号全字
  • 分区十进制
偏移量
指定与开头(数据开始的位置)的距离。 偏移量 0 是字段的开头。
长度
要捕获的字段的长度。长度为 0 表示一直捕获到数据区或容器的结尾处。例如,在发出容器的内容而不管其长度如何时,该值很有用。
精度
选择数字和科学记数型业务信息项的精度。为其他业务信息项禁用该字段。
代码页
选择代码页。对于某些业务信息项(例如来自另一来源的应用程序数据),该字段已禁用。

系统捕获点的“编辑信息源”窗口

突出显示该表中的某个信息源并单击编辑时,将打开“编辑信息源”面板。CICS 可识别所有信息源的格式。
图 2. 该图像显示了当为系统捕获点选择 FILE ENABLE 时可能会显示的“信息源”面板。
系统捕获点的“编辑信息源”面板的图像。
编辑信息源”面板的“可用数据”窗格包含以下字段:
上下文
上下文字段用于捕获关于系统上下文的数据。有效的上下文选项包括:
TRANSID
USERID
系统事件数据
“系统事件数据”字段用于捕获关于发生的系统事件的数据。系统事件数据因指定的捕获点而异。

根据您在“捕获点”选项卡的“系统捕获点”窗格中选择的选项,“编辑信息源”面板中会提供以下选项:

DB2 CONNECTION STATUS 的信息源

表 1.
选项 描述
DB2ID

如果没有使用组连接,该选项将返回 CICS DB2 连接所连接到的 DB2 子系统的名称,或您指定的让 CICS 连接到的 DB2 子系统的名称(如果 CICS DB2 连接未进行连接的话)。

有关更多信息,请参阅 INQUIRE DB2CONN 中的 DB2ID。

DB2GROUPID

如果正在使用组连接,该选项将返回您指定的 DB2 子系统的数据共享组或子组的名称。

有关更多信息,请参阅 INQUIRE DB2CONN 中的 DB2GROUPID。

DB2RELEASE

返回一个 4 字符的值,该值指示 CICS 连接到的 DB2 子系统的版本和发行版级别。

有关更多信息,请参阅 INQUIRE DB2CONN 中的 DB2RELEASE。

FROM_CONNECTST
一个字符串,它表示 CICS DB2 连接的状态。可能值包括:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

有关更多信息,请参阅 INQUIRE DB2CONN 中的 CONNECTST。

TO_CONNECTST
一个字符串,它表示 CICS DB2 连接的状态。可能值包括:
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

有关更多信息,请参阅 INQUIRE DB2CONN 中的 CONNECTST。

FILE ENABLE STATUS 的信息源

表 2.
选项 描述
FILE

指定正在查询的文件的 8 字符名称。

有关更多信息,请参阅 INQUIRE FILE 中的 FILE。

DSNAME

返回与 FILE 定义关联的 BDAM 数据集或 VSAM 对象的 44 字符名称。

有关更多信息,请参阅 INQUIRE FILE 中的 DSNAME。

FROM_ENABLESTATUS
一个字符串,它标识应用程序是否可以访问该文件。可能值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

有关更多信息,请参阅 INQUIRE FILE 中的 ENABLESTATUS。

TO_ENABLESTATUS
一个字符串,它标识应用程序是否可以访问该文件。可能值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

有关更多信息,请参阅 INQUIRE FILE 中的 ENABLESTATUS。

OPENSTATUS
一个字符串,它标识文件已打开、已关闭还是处于过渡状态。可能值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

有关更多信息,请参阅 INQUIRE FILE 中的 OPENSTATUS。

FILE OPEN STATUS 的信息源

表 3.
选项 描述
FILE

指定正在查询的文件的 8 字符名称。

有关更多信息,请参阅 INQUIRE FILE 中的 FILE。

DSNAME

返回与 FILE 定义关联的 BDAM 数据集或 VSAM 对象的 44 字符名称。

有关更多信息,请参阅 INQUIRE FILE 中的 DSNAME。

FROM_OPENSTATUS
一个字符串,它标识文件已打开、已关闭还是处于过渡状态。可能值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

有关更多信息,请参阅 INQUIRE FILE 中的 OPENSTATUS。

TO_OPENSTATUS
一个字符串,它标识文件已打开、已关闭还是处于过渡状态。可能值包括:
  • CLOSED
  • CLOSEREQUEST
  • OPEN

有关更多信息,请参阅 INQUIRE FILE 中的 OPENSTATUS。

ENABLESTATUS
一个字符串,它标识应用程序是否可以访问该文件。可能值包括:
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

有关更多信息,请参阅 INQUIRE FILE 中的 ENABLESTATUS。

TASK THRESHOLD 的信息源

表 4.
选项 描述
FROM_TASKS

指定事件之前的连接任务数。

TO_TASKS

指定事件之后的连接任务数。

MAXTASKS

返回此 CICS 中随时可分派的任务的最大数量。

有关更多信息,请参阅 INQUIRE SYSTEM 中的 MAXTASKS。

PERCENT_MAXTASKS

以最大任务数的百分比形式,指定超过的阈值。

TRANCLASS TASK THRESHOLD 的信息源

表 5.
选项 描述
TRANCLASS

指定正在查询的事务类的 8 字符名称。如果该类是 CICS 的较早发行版中使用的编号类之一,那么其名称为 DFHTCLnn,其中 nn 是两位类编号。

有关更多信息,请参阅 INQUIRE TRANCLASS 中的 TRANCLASS。

FROM_ACTIVE

返回事务类中在事件之前的活动任务数。

TO_ACTIVE

返回事务类中在事件之后的活动任务数。

MAXACTIVE

返回事务类中可同时执行的任务的最大数量。

有关更多信息,请参阅 INQUIRE TRANCLASS 中的 MAXACTIVE。

PERCENT_MAXACTIVE

以最大活动任务数的百分比形式,指定超过的阈值。

UNHANDLED TRANSACTION ABEND 的信息源

表 6.
选项 描述
TRANSACTION

指定发出未处理的事务异常终止的事务标识。

ABCODE

指定四个字符的事务转储异常终止代码。

有关更多信息,请参阅添加捕获规范