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.

I dati possono essere utilizzati tramite una delle strutture di associazione riportate nella seguente tabella, con un layout dell'evento denominato definito nell'editor del bind dell'evento:
Tabella 1. Associazione strutture
Nome Lingua Libreria
DFHEPFED Assembler SDFHMAC
DFHEPFEH C/C++ SDFHC370
DFHEPFEL PL/I SDFHPL1
DFHEPFEO COBOL SDFHCOB
La struttura EPFE consiste di dati contestuali associati all'evento. Ad esempio:
  • 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.
Nota:

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 troncati vengono gestiti come segue:
  • 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.