Traccia

I parametri contenuti nel La sezione TRACING del file consente di accendere e spegnere la funzione di traccia per i componenti di InterChange Server e di specificare il livello di traccia.

DB_CONNECTIVITY

Il livello di traccia per le interazioni tra InterChange Server servizio di connettività database e il server DBMS. Il servizio di connettività database ICS utilizza le API JDBC (Java Database Connectivity) per comunicare con un server database.

Tentare l'esecuzione della traccia del servizio database se si suppone che ICS stia avendo problemi con l'accesso al server DBMS. Ad esempio, se System Manager impiega troppo tempo per completare le modifiche di configurazione inserite, è possibile verificare la connessione.

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Stampa messaggi quando il servizio di connettività database si collega o si disconnette da un'origine dati, visualizzando le istruzioni attuali. Stampa inoltre i messaggi quando il servizio di connettività database crea o elimina i pool di connessione per i servizi di InterChange Server.
2 Stampa messaggi per il livello 1. Inoltre, stampa i messaggi descrivendo le connessioni create e rilasciate.
3 Stampa i messaggi per i livelli 1 e 2. Inoltre, stampa messaggi che indicano ogni passo interno intrapreso per rilevare connessioni disponibili. Questi passaggi comportano lo scavenging dei pool di connessione esistenti delle connessioni utilizzate più di recente.
4 Stampa messaggi per i livelli da 1 a 3. Inoltre, fornisce più dettagli sui passaggi intrapresi per rilevare le connessioni disponibili.
5 Stampa i messaggi per i livelli da 1 a 4. Inoltre, stampa messaggi sulla chiusura delle connessioni inattive.

Esempio: DB_CONNECTIVITY = 1

Predefinito

DB_CONNECTIVITY = 0
 

FLOW_MONITORING

Il livello di traccia per i messaggi interni.

Nota:
Questa voce viene utilizzata solo per l'esecuzione del debug. Non confondere questa funzione con il monitoraggio del flusso.

E' possibile impostare i livelli di traccia tra 0 e 5.

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Stampa i messaggi all'avvio (dove la traccia viene configurata per una collaborazione e visualizza la configurazione nel database).
2 Stampa i messaggi per il livello 1. Inoltre, include la rimozione eventi dalla coda interna.
3 Stampa i messaggi per i livelli 1 e 2. Inoltre, stampa un messaggio quando un record eventi viene rimosso attraverso le API.
4 Stampa messaggi per i livelli da 1 a 3. Inoltre, stampa un messaggio quando un evento viene spedito alla coda interna.
5 Stampa messaggi per i livelli da 1 a 4. Inoltre, stampa quanto scritto dal database.

Esempio: F LOW_MONITORING = 1

Predefinito

FLOW_MONITORING = 0

EVENT_MANAGEMENT

Specifica il livello di traccia per il servizio di gestione eventi.

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Stampa le richieste del servizio' di gestione eventi nel database per memorizzare un evento o per modificare le informazioni relative allo stato di un evento. Le informazioni di traccia indicano il controller connettore che ha ricevuto l'evento e le collaborazioni a cui è stato inviato.
2 Stampa messaggi per il livello 1. Inoltre, stampa il contenuto della memoria interna code dei lavori in corso per ogni collaborazione. Il messaggio di traccia include il numero di eventi contenuti nella coda dei lavori in corso delle collaborazioni' ed il numero degli eventi in esecuzione. Verificare se gli elementi vengono spostati dalle code o se vengono semplicemente aggiunti.

Esempio:

EVENT_MANAGEMENT = 1

Predefinito

EVENT_MANAGEMENT = 0
 

MESSAGING

Il livello di traccia per le interazioni tra il driver di messaggistica ed il servizio di messaggistica.

Questo parametro riguarda il driver di messaggistica sulla macchina su cui risiede il file InterchangeSystem.cfg. Il driver di messaggistica viene utilizzato dai componenti di InterChange Server installati sulla macchina, come ad esempio:

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Esegue la traccia di ricevuta dei messaggi dei driver' di messaggistica e dell'invio dei messaggi al servizio relativo. Il messaggio di traccia specifica se il messaggio è un messaggio scritto (oggetto business) o non scritto (di gestione).
2 Stampa i messaggi per il livello 1. Stampa inoltre il contenuto degli oggetti business inviati e ricevuti.

Esempio:

MESSAGING = 2

Predefinito

MESSAGING = 0 
 

REPOSITORY

Il livello di traccia per il servizio di repository. Questo parametro visualizza gli oggetti di repository che vengono inseriti, recuperati ed eliminati.

E' possibile eseguire la traccia del servizio di repository quando si verificano dei problemi con gli oggetti di repository, come quelli che è possibile visualizzare attraverso System Manager.

E' possibile impostare la traccia del repository ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Stampa i messaggi quando il servizio di repository recupera un oggetto (e gli oggetti secondari se appropriati dal database in risposta ad una richiesta.
2 Stampa i messaggi per il livello 1. Inoltre, stampa un messaggio quando il servizio di repository aggiunge correttamente un oggetto nuovo al repository.
3 Stampa i messaggi per i livelli 1 e 2. Inoltre, stampa un messaggio quando il servizio di repository modifica correttamente un oggetto di repository.
4 Stampa i messaggi per i livelli da 1 a 3. Inoltre, stampa un messaggio quando il servizio di repository elimina correttamente un oggetto dal repository.
5 Stampa messaggi per i livelli da 1 a 4. Inoltre, stampa un messaggio quando il servizio di repository crea un oggetto helper. Un oggetto helper è il codice interno alla memoria che esegue le richieste e restituisce le informazioni dal server database. Esiste un oggetto helper per ogni tipo di oggetto memorizzato nel repository.
6 Stampa i messaggi per i livelli da 1 a 5. Inoltre, stampa un messaggio quando InterChange Server crea lo schema database per un oggetto di repository. Questi messaggi vengono visualizzati all'avvio.
7 Stampa i messaggi per i livelli da 1 a 6. Inoltre, traccia tutti i metodi di repository interni.

Esempio: REPOSITORY = 3

Predefinito

REPOSITORY = 0
 

TRACE_FILE

L'ubicazione in cui InterChange Server scrive i messaggi di traccia quando la funzione è attiva. E' possibile inviare messaggi di traccia ad output standard (STDOUT) o ad un di cui specificare il percorso completo.

Se non viene specificato un valore per questo parametro, InterChange Server scrive i messaggi nella destinazione per la registrazione, che è il valore del

parametro LOG_FILE.

Esempio: TRACE_FILE = logs\trace.log (nella directory ProductDir)

Predefinito

TRACE_FILE = STDOUT
 

MIRROR_TRACE_TO_STDOUT

Il parametro che consente di inviare i messaggi di traccia all'output standard e ad un file di traccia. Se il parametro TRACE_FILE è stato specificato in un file valido impostando allora i mirrorMIRROR_TRACE_TO_STDOUT = TRUE viene impostato l'output di traccia sull'output standard. Questo parametro verrà ignorato se non è stato impostato TRACE_FILE .

A causa del sovraccarico del mirroring del file di traccia, impostare il parametro su true solo durante lo sviluppo e l'esecuzione del debug. Impostarlo su false o non specificarlo affatto (nel qual caso il valore predefinito sarà false) durante la produzione.

Predefinito

Il valore predefinito per questo parametro è false (off).

MAX_TRACE_FILE_SIZE

Il limite di dimensione del file di traccia. E' possibile che il valore sia in KB (kilobyte), MB (megabyte) o GB (gigabyte). Se non è specificata nessuna unità, l'impostazione predefinita sarà in byte.

Esempi:

MAX_TRACE_FILE_SIZE = 100 KB 
  
 MAX_TRACE_FILE_SIZE = 5 MB 
  
 MAX_TRACE_FILE_SIZE = 1 GB 
  
 MAX_TRACE_FILE_SIZE = 8192
 

Se viene specificato un valore per questo parametro, viene implicitamente abilitata la funzione di archiviazione delle tracce.

Predefinito

il valore predefinito per questo parametro è UNLIMITED.

NUMBER_OF_ARCHIVE_TRACES

Il numero di archivio tracce da conservare. I nomi dei file di archivio derivano dal valore specificato TRACE_FILE. Questo parametro viene ignorato se il parametro MAX_TRACE_FILE_SIZE non viene specificato o se è impostato TRACE_FILE=STDOUT.

Esempio. Se, TRACE_FILE = traces\InterchangeSystem.trc nella directory ProductDir e NUMBER_OF_ARCHIVE_TRACES = 3

le tracce di archivio vengono denominate nel modo seguente (nella directory ProductDir):

traces\InterchangeSystem_Arc_01.trc 
 traces\InterchangeSystem_Arc_02.trc
 traces\InterchangeSystem_Arc_03.trc
 

Predefinito

Il numero predefinito di archivi è 5, a meno che questo parametro non venga sovrascritto daNUMBER_OF_ARCHIVE_TRACES o a meno che MAX_TRACE_FILE_SIZE non sia impostato su un valore diverso da UNLIMITED.

RELATIONSHIP.CACHING

Un trigger consente a ICS di scrivere un messaggio nel file di traccia ogni volta che carica o scarica le tabelle delle relazioni di una relazione statica nella memoria. Impostare questo parametro su 5 per attivare questa funzione di traccia. Un valore da 0 a 4 disattiva la funzione di traccia. Per impostazione predefinita, questo parametro non esiste nella sezione TRACING del file InterchangeSystem.cfg. Perciò, la funzione di traccia delle tabelle delle relazioni memorizzate viene disabilitata.

Esempio: RELATIONSHIP.CACHING=5

Predefinito

Il valore predefinito di questo parametro è 0.

TRANSACTIONS

Specifica il livello di traccia per il servizio di transazione.

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Stampa un messaggio quando viene avviata una transazione e quando si eseguono elaborazioni di post-commit delle code di transazione.
2 Stampa messaggi per il livello 1. Inoltre, stampa un messaggio quando il servizio di transazione salva lo stato di un oggetto business nella transazione.
3 Stampa messaggi per i livelli 1 e 2. Inoltre, stampa un messaggio quando viene commessa una collaborazione di transazione.
4 Stampa messaggi per i livelli da 1 a 3. Inoltre, stampa messaggi relativi al rollback delle collaborazioni. Viene visualizzato un messaggio quando inizia il rollback e all'esecuzione di ogni passaggio di compensazione.
5 Stampa i messaggi per i livelli da 1 a4. Inoltre, stampa un messaggio
al ripristino dell'avvio in attività che viene eseguito al riavvio di InterChange Server
dopo un'uscita inattesa. Il server riattiva le collaborazioni di transazione
interrotte dall'uscita inattesa e le ripristina. Il server
non distribuisce gli eventi alle collaborazioni fino a che il ripristino ad avvio in esecuzione non sia completo, lasciandoli nella coda, in cui sono disponibili per l'elaborazione
alla fine del periodo di recupero.

Esempio: TRANSACTIONS = 1

Predefinito

TRANSACTIONS = 0 
 

SERVER_MEMORY

Un trigger consente al server di eseguire il monitoraggio dell'utilizzo della memoria per i flussi di trigger degli eventi e per controllare l'aumento della memoria sospendendo l'attività degli adattatori.

E' possibile impostare la funzione di traccia nei parametri seguenti:
Parametro Descrizione
MEMORY_UPPER_THRESHOLD_PCT Percentuale di memoria massima
in cui il server sospende l'esecuzione degli adattatori.
MEMORY_LOWER_THRESHOLD_PCT Percentuale di memoria in cui
il server avvia la spaziatura dei listener.
MEMORY_CHECK_SLEEP Frequenza alla quale il thread del programma di controllo della memoria
verifica la memoria del server'
.
SLEEPTIME_AFTER_MAX_THRESHOLD Frequenza alla quale il thread del programma di controllo della memoria
verifica la memoria del server'
dopo aver sospeso l'attività degli adattatori.

Esempio:

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 75
 MEMORY_CHECK_SLEEP = 1
 SLEEPTIME_AFTER_MAX_THRESHOLD = 2
 

Predefinito

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 80
 MEMORY_CHECK_SLEEP = 0
 SLEEPTIME_AFTER_MAX_THRESHOLD = 5
 

Per visualizzare la traccia del thread del programma di controllo della memoria, aggiungere il parametro seguente alla sezione secondaria [TRACING]:

SERVER_MEMORY = da 1 a 3
 

DOMAIN_STATE_SERVICE

Il livello di traccia per il servizio stato dominio. Questo servizio tiene traccia dello stato di tutti i componenti contenuti in sistema.
Livello Descrizione
0 Nessuna traccia.
1 Stampa i messaggi quando un componente come un adattatore o una collaborazione vengono aggiunti o eliminati dal registro. Stampa inoltra i messaggi quando viene modificato lo stato di una componente, come quando un adattatore in esecuzione viene arrestato o messo in pausa.
2 Stampa i messaggi per il livello 1. Inoltre, stampa un messaggio quando viene richiamato uno dei metodi.

Esempio: DOMAIN_STATE_SERVICE = 1

Predefinito

DOMAIN_STATE_SERVICE = 0 
 

MQSERIES_TRACE_LEVEL

Il livello di traccia per l'esecuzione del debug della connessione con il sistema di messaggistica di WebSphere MQ. I livelli di traccia forniscono informazioni sulle connessioni di InterChange Server al canale di WebSphere MQ. E' possibile trovare ulteriori informazioni eseguendo una ricerca dell'area della guida WebSphere MQ relativa alla funzione di traccia. Per avviare una ricerca,andare al menu Start > Programmi > WebSphere MQ > Centro informazioni WebSphere MQ e fare clic sulla scheda Cerca.

E' possibile impostare la funzione di traccia ai livelli seguenti:
Livello Descrizione
0 Nessuna traccia.
1 Fornisce l'entrata, l'uscita e la traccia delle eccezioni.
2 Stampa i messaggi per il livello 1. Inoltre, fornisce informazioni sui parametri.
3 Stampa i messaggi per i livelli 1 e 2. Inoltre, fornisce intestazioni MQ trasmesse e ricevute e blocchi di dati.
4 Stampa i messaggi per i livelli da 1 a 3. Inoltre, fornisce dato dei messaggi utenti trasmessi e ricevuti.
5 Stampa messaggi per i livelli da 1 a 4. Inoltre, fornisce la traccia dei metodi utilizzati in JVM (Java Virtual Machine.

Predefinito

MQSERIES_TRACE_LEVEL = 0
 

MQSERIES_TRACE_FILE

Il file a cui vengono inviati i messaggi di traccia WebSphere MQ quando è attiva la funzione di traccia. Se non viene specificato un valore per questo parametro, verrà utilizzato il nome file predefinito: ProductDir\mqseries\CwMQ.trc.

Esempio: MQSERIES_TRACE_FILE = MQSeries.trace.log (nella directoryProductDir)

Predefinito

MQSERIES_TRACE_FILE =mqseries\CwMQ.trc(nella directoryProductDir)

Copyright IBM Corp. 1997, 2004