Comando mqsichangetrace - sistemi Windows, Linuxe AIX

Alcuni parametri hanno nomi lunghi alternativi; ad esempio, -e e --integration-server sono nomi di parametri alternativi per un nome server di integrazione. I nomi estesi disponibili sono elencati nella sezione Parametri.

integrationNodeName | --integration-node integrationNodeName

(Obbligatorio) Specificare il nome del nodo di integrazione che si desidera tracciare. tutti i nomi sono sensibili al maiuscolo / minuscolo sui sistemi Linux® e AIX® .

-c misurare | --size misurare

(Facoltativo) La dimensione del file di traccia in KB (kilobyte). Se non si specifica questo parametro, il valore corrente non viene modificato.

Ogni nodo di integrazione inizia con un valore predefinito di 102400 KB. Specificare questa opzione per reimpostare il valore.

Se si modifica questo valore, ciò influisce sulla traccia per il server di integrazione (se ne si specifica uno) o per il componente (se non si specifica un server di integrazione).

-e integrationServerName | --integration-server integrationServerName

(Obbligatorio per la traccia utente. Richiesto per la traccia del servizio se non si specifica l'indicatore -b )

Identifica il server di integrazione per il quale le opzioni di traccia devono essere modificate (ad esempio, avviate o arrestate).

-l livello | --level livello

(Facoltativo) Imposta il livello della traccia. Sono supportate le seguenti opzioni:

• normal. Questa opzione fornisce un livello di base di informazioni di traccia.
• none. Questa opzione disattiva la traccia.
• debug. Questa opzione fornisce una traccia più completa.
• debugTree. Questa opzione fornisce la traccia di debug con l'aggiunta dei dettagli del messaggio.
• diagnostic. Questa opzione fornisce una traccia molto dettagliata, che deve essere utilizzata solo quando esplicitamente richiesto.
• diagnosticTree. Questa opzione fornisce la traccia diagnostica con l'aggiunta dei dettagli del messaggio.

Ogni nodo di integrazione viene creato con il valore predefinito none. Se non si specifica questo parametro, il valore corrente non viene modificato. Quando questo valore viene modificato correttamente, è persistente.

-m modalità | --mode modalità

(Facoltativo) Indicare il modo in cui le informazioni di traccia devono essere memorizzate nel buffer:

• safe. Questa modalità fa sì che le voci di traccia vengano scritte nel file quando vengono generate.
• fast. Questa modalità fa in modo che le voci di traccia vengano memorizzate nel buffer e scritte nel file in batch.
• temp= Un elenco separato da virgole di messaggi BIP per disabilitare la traccia alla ricorrenza di uno di essi. È possibile specificare fino a 10 messaggi BIP.

Ogni nodo di integrazione inizia con un valore predefinito di safe. Se non si specifica questo parametro, il valore corrente non viene modificato.

Se si modifica questo valore, ciò influisce sulla traccia per il server di integrazione (se ne si specifica uno) o per il componente (se non si specifica un server di integrazione).

-r | --reset

(Facoltativo) Questa opzione richiede che la registrazione di traccia sia reimpostata; ovvero, tutti i record correnti vengono eliminati. Utilizzare questa opzione quando si avvia una nuova traccia per assicurarsi che tutti i record nella registrazione siano univoci sulla nuova traccia.

-u | --user-trace

(Obbligatorio per la traccia utente)

Specifica che le opzioni di traccia utente devono essere modificate.

--non-persist

(Facoltativo) Specifica che le modifiche non verranno conservate dopo il riavvio del nodo o del server.

-v | --trace traceFileName

(Facoltativo) Utilizzare questo parametro per indirizzare la traccia del servizio del comando mqsichangetrace a un file specificato.

-b | --component

Specifica che le opzioni di traccia del servizio per il componente secondario del nodo di integrazione specificato devono essere modificate (ad esempio, avviate o arrestate). È possibile specificare questo indicatore solo se si specifica anche -t.

È necessario specificare l'indicatore -b o -e, ma non entrambi.

-t | --service-trace

(Obbligatorio) Specifica che le opzioni di traccia del servizio devono essere modificate. Per impostazione predefinita, la traccia del servizio viene emessa in una directory predefinita nel modo seguente:

• Se è stato incluso il parametro --work-path nel comando ibmint create node , la traccia del servizio viene emessa nella directory specificata. Per ulteriori informazioni, vedi Comando ibmint create node.
• Se non è stato incluso il parametro --work-path nel comando ibmint create node , la traccia del servizio viene emessa in una directory predefinita come riportato di seguito:
  • Windows:%PROGRAMDATA%\IBM\MQSI\Common\log, dove %PROGRAMDATA% è la variabile di ambiente che definisce la directory di lavoro del sistema.
  • Linux /var/mqsi/common/log.

Per un server di integrazione gestito dal nodo, è possibile reindirizzare la traccia del servizio alla directory specificata aggiungendo la seguente voce al file server.conf.yaml :

# Set the directory to store trace files:
traceDirectory: C:\temp\myTraceDir

Per un server di integrazione indipendente, è possibile reindirizzare l'emissione della traccia del servizio specificando un valore per traceDirectory nel file server.conf.yaml . Ad esempio:

traceDirectory: '/var/mqsi/myTraceDir' # Set the directory to store trace files

-n | --trace-nodes

Specifica la modalità per il flusso di traccia. I valori validi sono on e off.

Questo comando, con questo indicatore o combinazione di indicatori, non è ancora abilitato per l'utilizzo con un nodo di integrazione.