Tracciamento del driver CLI con il comando db2trc on -cli

È possibile tracciare le chiamate di funzione della CLI in modo dinamico con il comando db2trc on -cli.

Informazioni su questa attività

Il file di traccia Db2® generato con il comando db2trc fmt -cli è simile a quello della traccia CLI. Utilizzando il comando db2trc on -cli, è possibile:

Attivare e disattivare dinamicamente la traccia senza dover riavviare l'applicazione.
Specificare il percorso e il nome del file di output della traccia.
Traccia un ID di processo specifico o un elenco di ID di processo.
Con l'opzione -dumpstmt è possibile ottenere i dettagli di tutti gli handle delle istruzioni che sono stati allocati dal driver CLI prima dell'abilitazione del trace di Db2.
È possibile formattare la traccia in file di testo separati, basati sull'ID del thread di un processo, se per il comando trace format viene specificata una directory esistente.

Importante: Non eseguire la traccia se non è necessario diagnosticare un problema. Il tracciamento riduce le prestazioni complessive del sistema.

Procedura

Abilitare la traccia CLI lanciando uno dei seguenti comandi:
- Per tracciare le attività del driver CLI nel buffer di memoria di tracciamento:
```
db2trc on -cli
```
- Per tracciare le attività del driver CLI in un file di dump binario:
```
db2trc on -cli -f dumpFile
```
  dove dumpFile è il nome del file di dump binario. È possibile qualificare il nome del file con il percorso della directory, come mostrato nell'esempio seguente:
```
db2trc on -cli -f c:\temp\clitrace\dump.file
```
  Se non si qualifica il nome del file con il percorso della directory, il file viene generato nel percorso in cui si lancia il comando db2trc.
- Per tracciare solo un ID di processo specifico:
```
db2trc on -cli -p pid
```
  Per tracciare solo un ID di processo specifico in un file:
```
db2trc on -cli -p pid -f dumpFile
```
  Per tracciare più ID di processo specifici:
```
db2trc on -cli -p pid,pid,...
```
  Per tracciare più ID di processo specifici in un file:
```
db2trc on -cli -p pid,pid,... -f dumpFile
```
  dove pid è l'ID del processo di un'applicazione CLI, come mostrato nell'esempio seguente:
```
db2trc on -cli -p 6860,6888 -f c:\temp\clitrace\dump.file
```
- Per tracciare le attività del driver CLI e ottenere i dettagli di tutti gli handle delle istruzioni che sono stati allocati dal driver CLI prima dell'abilitazione della traccia Db2, eseguire uno dei seguenti comandi:
```
db2trc on -cli -dumpstmt
db2trc on -cli -dumpstmt -f dumpFile
```
Eseguire lo scenario applicativo che si desidera analizzare.
Disattivare il tracciamento in uno dei seguenti modi.
- Se si è attivata la traccia senza specificare il parametro -f dumpFile, eseguire i seguenti comandi:
```
db2trc dump dumpFile
db2trc off
```
  dove dumpFile è il nome del file di dump della traccia binaria. È possibile qualificare il nome del file con il percorso della directory.
- Se si è abilitata la traccia specificando il parametro -f dumpFile, eseguire il seguente comando:
```
db2trc off
```
Formattate il file binario in una traccia CLI lanciando il seguente comando:
```
db2trc fmt -cli CLItraceName
```
CLItraceName può essere uno dei seguenti oggetti:
- Il nome del file di traccia formattato che deve essere creato.
```
db2trc fmt –cli c:\temp\clitrace\dump.file clitrcfile.txt
```
- Il nome del file di traccia formattato con il nome del percorso.
```
db2trc fmt –cli c:\temp\clitrace\dump.file c:\temp\clitrace\Clitrace.cli
```
- Una directory esistente per la quale si dispone del permesso di scrittura.
```
db2trc fmt –cli c:\temp\clitrace\dump.file c:\temp
```
Se la directory CLItraceName esiste e si dispone del permesso di scrittura, la traccia viene formattata in file di testo separati, basati sull'ID del thread di un processo. Se esiste una directory con lo stesso nome del valore CLItraceName e non si dispone dei permessi di scrittura per la directory, viene restituito un errore. Il nome dei file di traccia nella directory CLItraceName è composto da p<pid>t<tid>.cli.