FFDC (First Failure Data Capture)

La funzione FFDC raccoglie istantaneamente informazioni su eventi e condizioni che potrebbero portare a un errore. I dati acquisiti in questi file possono essere utilizzati per analizzare un problema. FFDC è destinato principalmente all'utilizzo da parte del servizio IBM . La presenza di un messaggio FFDC non sempre indica la presenza di un problema. Nei casi in cui si verifica un normale recupero, non è necessaria alcuna ulteriore azione. Dopo un numero massimo di giorni, questi file vengono eliminati automaticamente dal sistema.

[AIX Solaris HP-UX Linux Windows] [IBM i] Una volta raccolte le informazioni e salvate in un file di log, FFDC restituisce il controllo ai motori interessati.

Per impostazione predefinita, un file di log FFDC viene automaticamente eliminato per sette giorni. È possibile configurare la quantità di giorni tra le eliminazioni se si è preoccupati della quantità di spazio che i file di log FFDC stanno utilizzando.

Nel prodotto vengono fornite due implementazioni FFDC:

L'FFDC WebSphere , che è l'implementazione FFDC legacy. Questo FFDC può essere utilizzato solo nei prodotti WebSphere .
L'FFDC IBM , che è un'implementazione più componenziata e più generica che dipende esclusivamente dal JDK. Questo FFDC può essere utilizzato in processi client e da prodotti nonWebSphere , poiché è collegabile con raccoglitori dati, programmi di formattazione, provider e listener nonWebSphere .

Entrambe le implementazioni FFDC supportano la funzionalità del tipo di provider OnDirconfigurabile utilizzando la variabile di ambiente com.ibm.ffdc.log JVM (Java virtual machine). La funzionalità del provider OnDirinclude un provider integrato che archivia gli incidenti come file separati in una directory, insieme a un file di riepilogo separato. La variabile di ambiente com.ibm.ffdc.log JVM può essere impostata sui valori seguenti:

<nome_file>, dove nome_file è il nome di un singolo file o di un percorso di directory.
- Se nome_file esiste ed è il nome di un singolo file, tutte le informazioni di report di riepilogo e di incidente raccolte da FFDC vengono aggiunte a tale file.
- Se nome_file esiste ed è un percorso di directory, ogni volta che si verifica un incidente, viene creato un nuovo file in tale directory e tutte le informazioni sull'incidente e sul report di riepilogo per tale incidente vengono scritte in questo file appena creato. L'incidente viene aggiunto anche al report di riepilogo in questa directory.
- Se nome_file termina con un separatore di file (\ o /). ma un file con il nome specificato non esiste, viene creata una directory denominata nome_file . Quindi, ogni volta che si verifica un incidente, viene creato un nuovo file in tale directory e tutte le informazioni sull'incidente e sul report di riepilogo per tale incidente vengono scritte in questo file appena creato. L'incidente viene aggiunto anche al report di riepilogo in questa directory.
  Esempio di utilizzo:
```
Name: com.ibm.ffdc.log
Value: C:\my_FFDC_CP\
```
- Se nome_file non termina con un separatore di file (\ o /). e un file con il nome specificato non esiste, viene creato un singolo file e viene fornito il nome specificato. Tutte le informazioni di report di riepilogo e di incidente raccolte da FFDC vengono quindi aggiunte a tale file.
  Esempio di utilizzo:
```
Name: com.ibm.ffdc.log
Value: C:\my_FFDC_CP_log
```
System.out, che accoda gli incidenti e le informazioni del report di riepilogo al flusso di output stdout.
System.err, che aggiunge le informazioni sui report di riepilogo e sugli incidenti al flusso di output stderr. System.err è il valore predefinito per la variabile di ambiente Java com.ibm.ffdc.log .
Suppress, che causa l'eliminazione di tutte le informazioni raccolte FFDC.

Per ulteriori informazioni sulla specifica della variabile di ambiente JVM com.ibm.ffdc.log nella console di gestione, consultare l'argomento Proprietà personalizzate della Java virtual machine.

La specifica di un valore per la variabile di ambiente com.ibm.ffdc.log JVM è l'unico cambiamento di configurazione che è necessario apportare per sfruttare la funzione OnDirProvider. Il nuovo FFDC fornisce anche i meccanismi per scegliere eccessivamente questo provider o per utilizzare il proprio provider WebSphere .

la variabile com.ibm.ffdc.log può essere utilizzata anche per reindirizzare gli incidenti FFDC e il riepilogo creati nel prodotto. Se si desidera utilizzare la variabile com.ibm.ffdc.log per questo scopo, è necessario specificare una directory come valore della variabile. Pertanto, si consiglia che, se questa variabile viene utilizzata in un ambiente WebSphere Application Server , la specifica di questa variabile termini in un separatore di file (/ o \\) per evitare conflitti.

Evitare problemi: se l'impostazione predefinita per l'eliminazione automatica delle informazioni FFDC è troppo lunga per l'ambiente, consultare l'argomento Configurazione delle eliminazioni del file di log FFDC (first failure data capture) per una descrizione di come è possibile modificare il periodo di tempo in cui le informazioni FFDC vengono conservate sul sistema.