Formato CBE (Common Base Event)

Il formato CBE (Common Base Event) è basato sulla specifica CBE (Common Base Event) versione 1.0.1, un formato basato su XML, che utilizza lo slot xs:any nello schema CBE (Common Base Event) per i dati evento CICS® . Può essere utilizzato da qualsiasi consumer che può riconoscere il formato XML CBE (Common Base Event).

Specificare il formato dell'evento che si desidera utilizzare utilizzando l'editor del bind evento. Per ulteriori informazioni sulle proprietà dell'adattatore e sui formati supportati, consultare Specifying EP adapter and dispatcher information in CICS Explorer product documentation.

Questo frammento di codice mostra il formato emesso se si seleziona il formato CBE (Common Base Event) nell' Editor di bind evento. I campi successivi in questa sezione tra parentesi graffe {} sono campi derivati dall'evento acquisito o dalla region CICS in cui è stato acquisito l'evento.

Figura 1. Esempio di formato CBE (Common Base Event)

<?xml version="1.0"?>
<cbe:CommonBaseEvent xmlns:cbe="http://www.ibm.com/AC/commonbaseevent1_0_1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
version="1.0.1"
creationTime="{yyyy-mm-ddThh:mm:ssZ}">
<cbe:sourceComponentId component="IBM CICS TS#5.4.0"
componentIdType="ProductName" executionEnvironment="IBM z/OS"
instanceId="{NETQUAL}.{APPLID}" location="{MVSSYSTEM}"
locationType="Hostname" subComponent="CICS EP"
componentType="http://www.ibm.com/xmlns/prod/cics/eventprocessing" />
<cbe:situation categoryName="OtherSituation">
<cbe:situationType xsi:type="OtherSituation"
reasoningScope="EXTERNAL">
<CICSApplicationEvent/>
</cbe:situationType>
</cbe:situation>
<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:ss.mmmZ</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>
</cbe:CommonBaseEvent>

Nota: 1 tutti gli eventi vengono emessi con data / ora UTC (Coordinated Universal Time).

L'elemento xs:any in un formato CBE (common base event) CICS contiene sia una parte statica (tag < cics: event>), che è la stessa per ogni formato CBE (common base event) CICS , sia una parte dinamica (tag < data:payload>), che è diversa per ciascuna specifica di evento. Le parti statiche e dinamiche sono descritte da schemi XML separati.

Lo schema XML statico viene installato con CICS nell'ubicazione: /usr/lpp/cicsts/cicsts54 /schemas/eventprocessing/eventformats/cics_cbe_static.xsd. È possibile esportare lo schema dinamico per un formato CBE (Common Base Event) CICS dalla scheda Adattatore nell' Editor di bind evento; per ulteriori dettagli, consultare Specifica delle informazioni sull'adattatore EP e sul dispatcher nella CICS Explorer .

Il contesto dell'evento CICS e i dati del payload sono contenuti negli elementi child < cics: context-info> e < cics: payload - data> dell'elemento < cics: event>. Lo schema dinamico fornisce l'associazione per i dati del payload.

Quando si inviano eventi in formato CBE (Common Base Event) CICS a un event consumer che non riconosce il formato CBE (Common Base Event), ad esempio IBM WebSphere® Message Broker, utilizzare lo schema XML statico per il formato CBE (Common Base Event). Per ulteriori informazioni, vedere Schema XML Common Base Event.