CICS 序列化事件 (CFE) 格式
指定的 CICS® 序列化事件 (CFE) 格式选项将事件上下文和数据值组合为编程数据结构。
您可以使用事件绑定编辑器指定要使用的事件格式。 有关适配器属性和受支持格式的更多信息,请参阅 CICS Explorer 产品文档中的 "指定 EP 适配器和分派器" 信息。
CFE 格式具有一个包含上下文数据的静态部分和一个包含每个事件特有数据的动态部分。
| 名称 | 语言 | 库 |
|---|---|---|
DFHEPFED |
汇编语言 | SDFHMAC |
DFHEPFEH |
C®/C++ | SDFHC370 |
DFHEPFEL |
PL/I | SDFHPL1 |
DFHEPFEO |
COBOL | SDFHCOB |
- EPFE
- EPFE_Context_Data
- 事件上下文标识。
- 事件上下文版本。
- 事件上下文事件绑定名称。
- 事件绑定用户标记。
- 事件业务名。
- 网络工作单元标识。 设置为策略事件或系统事件的二进制零 (NULL)。
- 网络限定应用程序标识。
- 捕获日期和时间。 所有事件都以 RFC3339 格式的全球标准时间 (UTC) 时间戳记发出。
- 捕获规范名称。
- EPFE_Context_Data
事件的动态部分在名为 EPFEEventData的部分中跟随 EPFE_Context_Data 。 这些数据采用基于文本的非 XML 格式。 EPFEEventData 部分中每个项的长度和顺序如事件规范中所定义。 这些项的长度和顺序在事件绑定编辑器中的已发出的业务信息部分中指定。
可以使用事件绑定编辑器,导出用于描述 CFE 事件的 EPFEEventData 部分的 COBOL 副本。 如果您所具有的事件绑定并非使用事件绑定编辑器创建,那么可以将其装入到事件绑定编辑器中以便导出相应的副本,或从事件绑定的 EventInformationItem 详细信息中获得期望的事件内容。
如果在事件绑定编辑器的“已发出的业务信息”表中将格式长度指定为自动,那么这表示已发出的业务信息项的长度将从捕获到的字段的长度和类型派生。 (如果有多个捕获规范,那么使用第一个。) 在避免发生因为指定的长度过短而导致数据被截断或以星号形式发出的情况时,该值十分有用。
另一个选项是捕获规范信息源中为数据项指定的捕获长度,长度为 0 表示一直捕获到数据区或容器的末尾。 例如,在发出容器的内容而不考虑其长度时,该值十分有用。
当事件绑定编辑器无法确定已发出的业务信息所需的长度时,将打开一个关于副本导出的错误窗口,且无法创建副本。 例如,当 CHAR 或 HEX 项的格式长度为自动且捕获长度为 0,就会出现这种情况。 您应为发出的数据项指定非零长度;否则,使用事件的任何应用程序都需要知道如何解释这些数据项。 类似地,将浮点数据格式化为数字或文本时,已发出的业务信息的长度取决于该数据字段的值,并且要到运行时才能确定。 您应指定非零的长度,可能还需要为已发出的业务信息项指定精度值。
当捕获到以 null 结束的字符串时,格式化的事件数据不以 null 结束,这样处理程序可以对不以 null 结束的字符数组使用正确的功能。 DFHEPDE 中的数据类型为 CHARZ 或 HEXZ(而非 CHAR 或 HEX),这样 EP 适配器可以根据需要再次创建以 null 结束的项。
- 对于数字数据,当大小超过格式长度字段的值时,它会以星号形式发出,以指示发生了溢出。 格式长度是在事件绑定编辑器中为发出的业务信息字段指定的长度。
- 对于文本数据,当大小超过格式长度字段的值时,它会被截断。
- 对于捕获规范中类型为十六进制的十六进制数据,当大小超过格式长度字段的值时,如果格式类型为字符,那么它会被截断,或者如果格式类型为数字,那么它会以星号形式发出。