公共基本事件 REST 格式

公共基本事件 REST 格式是 CICS® 事件的基本 XML 表示。 公共基本事件 REST 格式可以由需要事件格式为 XML 的任何事件处理 HTTP 服务器使用。

您可以使用事件绑定编辑器指定要使用的事件格式。 有关适配器属性和受支持格式的更多信息,请参阅 CICS Explorer 产品文档中的 "指定 EP 适配器和分派器" 信息

此格式是一种基于 XML 的格式,用于表示 CICS 事件。 该格式与公共基本事件格式的 xs:any 槽中的 XML 完全相同。

此代码片段显示在 事件绑定编辑器中选择公共基本事件 REST 格式时发出的格式。 在花括号 {} 中的本节后面的字段是派生自捕获事件或捕获事件所在的 CICS 区域的字段。

图 1。 公共基本事件 REST 格式示例
<?xml version="1.0"?>
<cics:event
xmlns:cics="http://www.ibm.com/xmlns/prod/cics/events/CBE">
<cics:context-info>
<cics:eventname>{BusinessEvent}</cics:eventname>
<cics:usertag>{User Tag}</cics:usertag>
<cics:networkapplid>{NETQUAL}.{APPLID}</cics:networkapplid>
<cics:timestamp>yyyy-mm-ddThh:mm:ssZ</cics:timestamp>  1 
<cics:bindingname>{Event Binding Name}</cics:bindingname>
<cics:capturespecname >{Capture Spec Name}</cics:capturespecname >
<cics:UOWid>{network unit of work id}</cics:UOWid>
</cics:context-info>
<cics:payload-data>
<data:payload xmlns:data="http://www.ibm.com/prod/cics/{User Tag}/{BusinessEvent}">
<data:customer>IBM</data:customer>
<data:orderValue>10250</data:orderValue>
<data:orderReference>QWERTY098765</data:orderReference>
</data:payload>
</cics:payload-data>
</cics:event>
注: 1 所有事件都以全球标准时间 (UTC) 时间戳记发出。

CICS 通用基本事件 REST 格式包含静态部分(<cics:event> 标签)和动态部分(<data:payload> 标签),前者对于每个 CICS 通用基本事件 REST 事件都是相同的,后者对于每个事件规范都是不同的。 静态和动态部分由不同的 XML 模式描述。

静态 XML 架构与 CICS 一起安装在 /usr/lpp/cicstsnn/schemas/eventprocessing/eventformats/cics_cbe_static.xsd 中,其中 nn 反映 CICS 的版本:例如, /usr/lpp/CICSTS63/schemas/eventprocessing/eventformats/cics_cbe_static.xsd 用于 CICS TS 6. 3。 您可以从事件绑定编辑器中的适配器选项卡导出通用基本事件 REST 格式事件的动态模式;更多详情,请参阅 CICS Explorer 产品文档中的指定 EP 适配器和调度器信息

CICS 事件上下文和有效载荷数据包含在 <cics:event> 元素的 <cics:context-info> 和 <cics:payload-data> 子元素中。 动态模式提供有效内容数据的映射。