“信息源”选项卡

使用信息源选项卡可定义此捕获规范获取已发出的业务信息的位置。

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

使用此选项卡可将与事件规范关联的业务信息项映射到该捕获点的可用数据项。

“信息源”选项卡

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

应用程序捕获点的“信息源”对话框

要打开信息源的“信息源”对话框,可在表中选择信息源,然后单击编辑,也可以双击信息源。

以下示例显示了为应用程序捕获点选择 REWRITE 时的“信息源”对话框。

图 1. 应用程序捕获点的“信息源”对话框
应用程序捕获点的“信息源”对话框。

“可用数据”字段

“可用数据”部分包含以下字段:
上下文
上下文字段用于捕获有关应用程序上下文的数据。有效的上下文选项包括:
PROGRAM
TRANSID
USERID
事件选项
事件选项用于捕获 CICS® 命令上的选项的值。事件选项因指定的捕获点而异。
应用程序数据
捕获规范中的这些谓词用于过滤 CICS 命令中指定的应用程序数据。 应用程序数据因指定的捕获点而异。仅当在“可用数据”部分中选择了应用程序数据项时,此对话框中才会提供副本导入和格式设置选项。
根据您在“可用数据”部分中选择的选项,“信息源”对话框中有以下可用字段:
容器
指定 CICS 通道容器。仅当应用程序数据指定了通道时才可以选择容器字段。在所有其他情况下,该字段处于禁用状态。

单击从导入的语言结构中选择以导入语言结构。然后,您可以从语言结构中选择要捕获的字段。 如果使用此选项,将自动填写类型偏移量长度字段。或者,您可以指定类型偏移量长度值。

类型
指定应用程序数据谓词的数据类型。可用的数据类型如下:
  • 二进制浮点
  • 字符
  • 以 NULL 终止的字符
  • 十进制浮点
  • 十六进制
  • 以 NULL 终止的十六进制
  • 十六进制浮点
  • 压缩十进制
  • 带符号半字
  • 带符号全字
  • 无符号半字
  • 无符号全字
  • 分区十进制
偏移量
指定与开头(数据开始的位置)的距离。 偏移量为 0 表示字段的开头。
长度
指定要捕获的字段长度。指定长度 0 表示一直捕获到数据区或容器末尾。 指定长度 0 具有以下影响:
  • 对于在 API 命令的独立参数中指定了数据区长度(或转换程序的缺省值)的 API 命令,将捕获数据区或容器的所有内容,不受其长度影响。例如,如果在 LINK 命令上指定了 COMMAREA 和 LENGTH,那么将捕获所有数据。
  • 对于被捕获数据区没有长度参数的 API 命令,将不会捕获任何数据。例如,在 READ 命令上指定了 RIDFLD,或者在 RECEIVE MAP 命令上指定了 INTO,但没有相关联的长度参数,因此将捕获 0 字节的数据。
精度
选择数字和科学记数型业务信息项的精度。对于其他业务信息项,该字段处于禁用状态。
代码页
选择代码页。对于某些业务信息项(例如,来自其他源的应用程序数据),该字段处于禁用状态。有关代码页的更多信息,请参阅编码字符集引用材料
静态数据
为了将不可更改的数据传递到事件使用者,您可以指定要与事件关联的静态数据。可以定义最多 255 个字符(包括空格)的静态值。有效字符集如下所示:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

系统捕获点的“信息源”对话框

要打开信息源的“信息源”对话框,可在表中选择信息源,然后单击编辑,也可以双击信息源。CICS 可识别所有信息源的格式。

以下示例显示了为系统捕获点选择 FILE ENABLE 时的“信息源”对话框。

图 2. 系统捕获点的“信息源”对话框
系统捕获点的“信息源”对话框
“可用数据”部分包含以下字段:
上下文
上下文字段用于捕获有关系统上下文的数据。有效的上下文选项包括:
TRANSID
USERID
系统事件数据
“系统事件数据”字段用于捕获有关发生的系统事件的数据。系统事件数据因指定的捕获点而异。
静态数据
为了将不可更改的数据传递到事件使用者,您可以指定要与事件关联的静态数据。可以定义最多 255 个字符(包括空格)的静态值。有效字符集如下所示:

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

下表列出了“信息源”对话框中可用的字段,具体取决于您在捕获点选项卡“系统捕获点”窗格中选择的系统捕获点。

DB2 CONNECTION STATUS 的信息源

表 1. DB2 CONNECTION STATUS 的信息源
选项 描述
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 ENABLE STATUS 的信息源
选项 描述
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 OPEN STATUS 的信息源
选项 描述
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。

MESSAGE 的信息源

表 4. MESSAGE 的信息源
选项 描述
INSERTnn 指定您所查询的消息的 INSERTnn 值,其中,nn 是 1 到 30 之间的插入标识。
MESSAGE_ID 指定您所查询的消息的 9 字符消息号。
MESSAGE_TEXT 将消息的整个文本指定为事件中的输出字段。如果要捕获整个消息,请使用此选项。捕获的消息文本的最大长度是 1024 个字节。如果消息长于 1024 个字节,那么会截断此消息。
注: 所有消息在捕获时都使用的是 NATLANG 系统初始化参数定义的语言,但发送至 CICS 控制台的消息在捕获时使用的是英语。

TASK THRESHOLD 的信息源

表 5. TASK THRESHOLD 的信息源
选项 描述
FROM_TASKS

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

TO_TASKS

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

MAXTASKS

返回 CICS 系统中任意时刻符合分派资格的最大任务数。

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

PERCENT_MAXTASKS

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

TRANCLASS TASK THRESHOLD 的信息源

表 6. TRANCLASS TASK THRESHOLD 的信息源
选项 描述
TRANCLASS

指定您所查询的事务类的 8 字符名称。如果该类是 CICS 较早发行版中使用的带编号类,那么该类的名称为 DFHTCLnn,其中 nn 是 2 位数的类编号。

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

FROM_ACTIVE

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

TO_ACTIVE

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

MAXACTIVE

返回允许在事务类中并发运行的最大任务数。

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

PERCENT_MAXACTIVE

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

UNHANDLED TRANSACTION ABEND 的信息源

表 7. UNHANDLED TRANSACTION ABEND 的信息源
选项 描述
TRANSACTION

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

ABCODE

指定 4 字符事务转储异常终止代码。

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