Formato CFE (CICS flattened event)
L'opzione del formato CICS® Flattened Event (CFE) specificata assembla il contesto dell'evento e i valori dei dati come struttura dei dati di programmazione.
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.
Il formato CFE ha una parte statica che contiene i dati di contesto ed una parte dinamica contenente i dati specifici di ogni evento.
| Nome | Lingua | Libreria |
|---|---|---|
DFHEPFED |
Assembler | SDFHMAC |
DFHEPFEH |
C/C++ | SDFHC370 |
DFHEPFEL |
PL/I | SDFHPL1 |
DFHEPFEO |
COBOL | SDFHCOB |
- EPFE
- Dati_conto_EPFE
- L'identificativo del contesto dell'evento.
- La versione del contesto dell'evento.
- Il nome di bind del contesto dell'evento.
- Il tag utente dell'utente del bind dell'evento.
- Il nome aziendale dell'evento.
- L'ID dell'unità di lavoro di rete.1
- L'applid completo della rete.
- La data e l'ora della cattura.2
- Il nome della specifica di cattura.
- Dati_conto_EPFE
1L'ID dell'unità di lavoro di rete è impostato su zero binari (NULL) per un evento della politica o di sistema.
2 Tutti gli eventi vengono emessi con data / ora UTC (Coordinated Universal Time) in formato RFC3339 .
La parte dinamica dell'evento segue EPFE_Context_Data in una sezione denominata EPFEEventData. Questi dati sono in un formato non XML, basato su testo. La lunghezza e l'ordine di ogni elemento nella sezione EPFEEventData sono quelli definiti nella specifica dell'evento. La lunghezza e l'ordine degli elementi sono specificati nella sezione Informazioni aziendali emesse nell'editor del bind evento.
È possibile utilizzare l'Editor del bind evento per esportare un quaderno COBOL che descrive la parte EPFEEventData dell'evento CFE. Se si dispone di un bind dell'evento che non è stato creato utilizzando l'editor del bind evento, è possibile caricarlo nell'editor per esportare il quaderno corrispondente, o per richiamare il contenuto previsto dell'evento dai dettagli EventInformationItem nel bind dell'evento.
Quando si specifica una lunghezza del formato Automatica nella tabella Informazioni aziendali emesse nell'editor del bind evento, questo indica che la lunghezza dell'elemento informazioni aziendali emesse è derivato dalla lunghezza e dal tipo del campo catturato. (Quando c'è più di una specifica di cattura, verrà utilizzato la prima.) Ciò è utile per evitare la situazione in cui la lunghezza specificata sia troppo piccola, il che determinerebbe il troncamento dei dati o la loro emissione come asterischi.
Un'altra opzione, la lunghezza di cattura specificata per un elemento di dati nelle Origini delle informazioni della specifica della cattura, è dove una lunghezza pari a 0 significa catturare fino alla fine dell'area dati o del contenitore. Cià è utile quando si emette, ad esempio, il contenuto di un contenitore a prescindere dalla sua lunghezza.
Quando l'editor del bind evento non può determinare la lunghezza richiesta per le informazioni aziendali emesse, viene visualizzata una finestra di errore sull'esportazione del quaderno e non sarà possibile creare un quaderno. Ciò avviene, ad esempio, quando la lunghezza del formato di un elemento HEX o CHAR è impostata su Automatica e la lunghezza di cattura è 0. È necessario specificare una lunghezza diversa da zero per l'elemento dei dati emessi; altrimenti, qualsiasi applicazione che utilizzi l'evento necessiterà di sapere come interpretare gli elementi dei dati. Allo stesso modo, quando i dati a virgola mobile vengono formattati come numerici o di testo, la lunghezza delle informazioni aziendali emesse dipende dal valore del campo dati e non è nota fino al runtime. È necessario specificare una lunghezza diversa da zero e possibilmente anche un valore di precisione per l'elemento delle informazioni aziendali emesse.
Quando vengono catturate stringhe null-terminated, i dati dell'evento formattati non sono null-terminated, in modo che il programma di elaborazione possa utilizzare la funzione corretta per gli array di caratteri che non sono null-terminated. I tipi di dati in DFHEPDE sono CHARZ o HEXZ (piuttosto che CHAR o HEX) in modo tale che l'adattatore EP possa creare nuovamente un elemento null-terminated, se necessario.
- I dati numerici dove la dimensione supera il valore del campo Lunghezza formato vengono emessi come asterischi, per indicare che si è verificato un overflow. La Lunghezza formato è la lunghezza specificata per il campo Informazioni aziendali emesse nell'editor del bind evento.
- I dati di testo in cui la dimensione supera il valore del campo Lunghezza formato vengono troncati.
- I dati esadecimali che sono di tipo Esadecimale nella specifica di cattura e che superano il valore del campo Lunghezza formato vengono troncati se il tipo di formato è Carattere, o vengono emessi come asterischi se il tipo di formato è numerico.