Descrizioni delle variabili di ambiente

Descrizioni delle variabili di ambiente server e client destinate all'utilizzo da parte del cliente.

Esempi di utilizzo

SUAIX® and Linux® sistemi, utilizzare questo formato:export [environment variable]=value .
SUWindows sistemi, utilizzare questo formato:Set [environment variable]=value .
Nei sistemi IBM® i , utilizzare questo formato: ADDENVVAR ENVVAR(environment variable) VALUE(xx).
PerIBM MQ Appliance , Vedere Configurazione delle variabili di ambiente suIBMMQ Appliance nelIBM MQ Appliance documentazione.

Tabella 1. Riepilogo delle variabili di ambiente
Nome	Descrizione	Sul client?
AMQ_ALLOWED_CIPHERS	Specifica un elenco personalizzato di CipherSpecs abilitati per l'utilizzo con i canali IBM MQ .
AMQ_APP_INSTANCE_MODE	Specifica se tutte le connessioni create da una macchina virtuale client Java vengono trattate come una singola istanza di applicazione.
DATA_FDCS BAD_AMQ	Fa sì che i file FFST vengano scritti per tutti i dati non corretti, inclusi i formati noti semplici, se IBM MQ riceve dati in un formato non corretto da un host su TCP/IP.
AMQ_CONVEBCDICNEWLINE	Specifica come IBM MQ deve convertire un carattere EBCDIC NL in formato ASCII.
AMQ_DIAGNOSTIC_MSG_SEVERITY	Specifica se la severità del messaggio deve essere accodata al numero del messaggio quando un processo IBM MQ scrive un messaggio in una registrazione errori o nella console.
AMQ_DISABILITA_CLIENT_AMS	Per i client Java , se si desidera connettersi a un gestore code da una versione precedente del prodotto, disabilita IBM MQ Advanced Message Security (AMS) sul client.
AMQ_DMPMQCFG_QSGDISP_DEFAULT	Specifica quali tipi di definizioni includere quando si interroga la disposizione di un gestore code.
AMQ_IODELAY, AMQ_IODELAY_INMS e AMQ_IODELAY_FFST	Utilizzato per ottimizzare la diagnostica e le tempistiche quando l'input e l'output per il file system di archiviazione e il log del gestore code sono lenti.
TRACCIA LDAP_AMQ	Consente di attivare e disattivare la traccia del client LDAP senza arrestare o avviare anche il gestore code.
AMQ_LICENSING_METRICA	Fa in modo che il gestore code carichi i dati relativi a tipi di licenze VPC mensili invece del comportamento predefinito di caricamento dei dati correlati alle licenze orarie basate sul contenitore.
AMQ_MQS_INI_POSIZIONE	Specifica l'ubicazione utilizzata per il file mqs.ini .
NO_AMQ_BAD_COMMS_DATA_FDCS	Elimina la generazione di FFST quando si riportano messaggi di errore sul flusso di comunicazioni iniziale se i dati che IBM MQ riceve da un host su TCP/IP hanno un formato non corretto.
AMQ_NO_IPV6	Disabilita l'utilizzo di IPv6 durante il tentativo di connessione.
AMQ_RDQM_NO_PING_CHECKS	Disabilita i ping ICMP in una configurazione RDQM.
AMQ_REVERSE_COMMIT_ORDER	Configura un gestore code in modo che in una transazione XA venga eseguito il commit della modifica del gestore code IBM MQ una volta completato l'aggiornamento del database corrispondente.
AMQ_SSL_CONSENTI_CERTIFICATO_PREDEFINITO	Consente al certificato che un'applicazione utilizza per connettersi a un gestore code di essere un certificato predefinito, purché sia presente un certificato predefinito nel repository delle chiavi e il repository delle chiavi non contenga un certificato personale con prefisso `ibmwebspheremquserid`.
AMQ_SSL_LDAP_SERVER_VERSION	Specifica che LDAP v2 o LDAP v3 viene utilizzato dai componenti crittografici IBM MQ nei casi in cui i server CRL richiedono l'uso di una versione specifica del protocollo LDAP.
AMQ_TLS_AMBIENTE_AMBITO	Controlla se IBM MQ utilizza un unico IBM Global Security Kit (GSKit) ambiente per l'intero processo o un IBM Global Security Kit (GSKit) ambiente per ogni connessione.
AMQ_USE_ZLIBNX	Su AIX, abilita gli MCA (message channel agent) ad utilizzare la libreria zlibNX accelerata dall'hardware per la compressione e la decompressione dei dati dei messaggi quando si utilizzano tecniche ZLIBFAST o ZLIBHIGH.
MQ_GMQ_LIB	Specifica la libreria di bind del client quando le classi di automazione IBM MQ per ActiveX (MQAX) vengono eseguite sul client anziché sul server. Attenzione: questa variabile di ambiente viene rimossa all'indirizzo 9.2.
HOME	Su AIX, Linux e IBM i, specifica il nome della directory in cui viene ricercato il file mqclient.ini .
HOMEDRIVE e HOMEPATH	Su Windows, utilizzato insieme per specificare il nome della directory in cui viene ricercato il file mqclient.ini .
LDAP_BASEDN	Ambiente richiesto per l'esecuzione di un programma di esempio LDAP. Specifica il DN (Distinguished Name) di base per la ricerca nell'indirizzario.
HOST_LDAP	Facoltativo per l'esecuzione di un programma di esempio LDAP. Specifica il nome dell'host su cui è in esecuzione il server LDAP.
VERSIONE LDAP	Facoltativo per l'esecuzione di un programma di esempio LDAP. Specifica la versione del protocollo LDAP da utilizzare.
MQCCDTCERTVPOL	Una variabile d'ambiente opzionale per la politica di convalida dei certificati CCDT che può essere configurata per la IBM MQ classes for JMS libreria client.
MQ_CHANNEL_SUPPRESS_INTERVAL	Specifica l'intervallo di tempo, in secondi, durante il quale i messaggi definiti con MQ_CHANNEL_SUPPRESS_MSGS devono essere eliminati dalla scrittura nel log degli errori, insieme al numero di volte in cui un messaggio può verificarsi durante l'intervallo di tempo specificato prima di essere eliminato.
MQ_CHANNEL_SUPPRESS_MSGS	Elimina i messaggi di errore del canale nel log degli errori.
TIPO_CONNET_MQ	Utilizzato in combinazione con il tipo di bind specificato nel campo Opzioni della struttura MQCNO utilizzato su una chiamata MQCONNX.
MQ_CROSS_QUEUE_ORDER_ALL	Specifica che l'ordine di inserimento del messaggio viene conservato in un'unità di lavoro.
MQ_EPHEMER_PREFIX	Specifica il percorso della directory temporanea del gestore code, all'interno della quale vengono conservati i dati del gestore code temporaneo, mentre il gestore code è in esecuzione.
MQ_FILE_PATH	Posizione dei file eseguibili. Impostare le variabili di ambiente di sistema durante la prima installazione di IBM MQ. Lo stesso percorso è memorizzato anche nel Windows Registro.
MQ_JAVA_DATA_PATH	Specifica la directory per l'output di log e traccia per IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaginge IBM MQ classes for Java.
PERCORSO_INSTALL_JAVA_MQ	Specifica la directory in cui sono installati IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaginge IBM MQ classes for Java .
MQ_JAVA_LIB_PATH	Specifica la directory in cui sono memorizzate le librerie IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaginge IBM MQ classes for Java .
MQ_LCLADDR	Sulle multipiattaforme, definisce un valore di indirizzo locale predefinito che viene utilizzato per tutti i canali mittente che non hanno un indirizzo locale definito.
MQ_OVERRIDE_DATA_PATH	Sovrascrive la directory predefinita del percorso dati IBM MQ .
MQ_SET_NODELAYACK	Su AIX, disattiva il riconoscimento ritardato TCP.
NOME MQ_USA	Consente a un'immagine non installata di IBM MQ su Linux di scegliere il nome di un utente senza nome.
FILE_LOG_MQAPI	Definisce il prefisso per il file specificato dall'utente in cui il programma di uscita API di esempio genera una traccia MQI.
MQAPPLNAME	Se il nome dell'applicazione non è stato ancora scelto, specifica il nome da utilizzare per identificare la connessione a un gestore code.
MQCCSID	Specifica il numero della serie di caratteri codificati da utilizzare e sostituisce il valore CCSID con cui è stato configurato il server.
URL MQCC	Fornisce la capacità equivalente di impostare una combinazione delle variabili di ambiente MQCHLLIB e MQCHLTAB .
MQCERTLABL	Definisce l'etichetta del certificato di una definizione di canale che IBM MQ deve utilizzare per individuare un certificato personale inviato durante un handshake TLS.
MQCERTVPOL	Specifica il tipo di politica di convalida del certificato da utilizzare.
MQCHLLIB	Specifica il percorso della directory del file che contiene la tabella di definizione del canale client (CCDT).
MQCHLTAB	Specifica il nome del file che contiene la CCDT (client channel definition table).
MQCLNTCF	Specifica l'ubicazione del file di configurazione IBM MQ MQI client .
TRACE_MQDOTNET_ON	Abilita la traccia per i client ridistribuibili IBM MQ .NET .
MQIPADDRV	Specifica quale protocollo IP utilizzare per una connessione di canale.
MQKEYRPWD	Specifica la password per il repository chiavi che contiene il certificato digitale appartenente all'utente.
MQLICENSE	Su sistemi Linux , utilizzato per accettare o visualizzare una licenza IBM MQ dopo l'installazione del prodotto.
MQMAXERRORLOGSIZE	Specifica la dimensione del log degli errori del gestore code copiato nel backup.
MQNAME	Specifica il nome NetBIOS locale che i processi IBM MQ possono utilizzare.
MQNOREMPOOL	Disattiva il pool di canali e causa l'esecuzione dei canali come thread del listener.
LOGFILE MQPSE_TRACE_	Descrive dove devono essere scritti i file di traccia per il programma di esempio di uscita di pubblicazione.
MQS_AMSCRED_XX_ENCODE_CASE_ONE file_chiave	Sovrascrive o fornisce il file di chiavi iniziale da utilizzare al runtime delle applicazioni IBM MQ Advanced Message Security (AMS) o quando si sta proteggendo un file di configurazione del keystore utilizzando il comando runamscred .
MQS_DISABILITA_TUTTE_LE_INTERCETTAZIONI	Per i client C nativi, se si desidera connettersi a un gestore code da una versione precedente del prodotto, disabilita IBM MQ Advanced Message Security (AMS) sul client.
HOST IP_MQS	Imposta il nome host che viene aggiunto al percorso della directory.
MQS_KEYSTORE_CONF	Specifica l'ubicazione del file di configurazione del keystore per IBM MQ Advanced Message Security (AMS), se il file non si trova nell'ubicazione predefinita.
MQS_MQI_XX_ENCODE_CASE_ONE file_chiave	Specifica l'ubicazione di un file di chiavi iniziale che contiene la chiave iniziale da utilizzare per le operazioni di protezione della parola d'ordine.
MQS_SSLCRYP_XX_ENCODE_CASE_ONE file_chiave	Specifica il nome e il percorso completo del file contenente la chiave iniziale utilizzata per codificare la password nella stringa di configurazione hardware crittografica PKCS #11 .
MQS_TRACE_OPZIONI	Per la traccia selettiva del componente su AIX, attiva singolarmente le funzioni di traccia dei parametri e dei dettagli elevati.
MQS_GETGROUPLIST_API	Restituisce tutte le informazioni sui gruppi e cerca l'utente `mqm` richiesto nei gruppi, senza causare un timeout interno del gestore delle code.
SERVER MQT	Definisce un canale minimo, specificando l'ubicazione del server IBM MQ e il metodo di comunicazione da utilizzare.
MQSNOAUT	Disabilita OAM (object authority manager) e impedisce qualsiasi controllo di sicurezza, ad esempio in un ambiente di test.
MQSPREFIX	In alternativa alla modifica del prefisso predefinito, sovrascrive DefaultPrefix per il comando crtmqm .
MQSSLCRYP	Contiene una stringa di parametri che è possibile utilizzare per configurare l'hardware crittografico presente nel sistema.
MQSSLFIPS	Specifica se devono essere utilizzati solo librerie e FIPS algoritmi crittografici certificati nel caso in cui la crittografia venga eseguita in IBM MQ. Specifica se devono essere utilizzati solo FIPS algoritmi certificati se la crittografia viene eseguita in IBM MQ.
MQSSLKEYR	Specifica l'ubicazione del repository chiavi che contiene il certificato digitale appartenente all'utente.	cliente e mqcertck strumento
MQSSLPROXY	Specifica il nome host e il numero di porta del server proxy HTTP che deve essere utilizzato da IBM Global Security Kit (GSKit) per i controlli OCSP.
RESET MQSS	Specifica il numero di byte non codificati inviati e ricevuti su un canale TLS prima che la chiave segreta TLS venga rinegoziata.
MQSUITEB	Specifica se deve essere utilizzata la crittografia conforme a Suite B. Nell'istanza in cui viene utilizzata la crittografia Suite B,
MQTCPTIMEOUT	Specifica il tempo di attesa di IBM MQ per una chiamata di connessione TCP.
MQTRACEPATH	Quando si eseguono tracce lunghe, si imposta il nome di una directory che dispone di più spazio su disco.
ODQ_MSG	Imposta il nome del file contenente i messaggi di errore e di informazione, se si utilizza un gestore code di messaggi non instradabili diverso da runmqdlq.
TRACCIA_ODQ	Abilita la traccia se si utilizza un gestore code di messaggi non recapitabili diverso da runmqdlq.
TOKENCERTVPOL	Una variabile d'ambiente opzionale per la politica di convalida dei certificati JWT che può essere configurata per la IBM MQ classes for JMS libreria client.
TRACE_WCF	Abilita la traccia per il canale personalizzato WCF.
WMQSOAP_HOME	Utilizzato quando si completano ulteriori operazioni di configurazione dopo che l'ambiente di hosting del servizio .NET SOAP over JMS viene installato e configurato correttamente in IBM MQ.
XMS_TRACE_ON, XMS_TRACE_FILE_PATH, XMS_TRACE_FORMAT e XMS_TRACE_SPECIFICATION	Utilizzato per abilitare e configurare la traccia XMS .

AMQ_ALLOWED_CIPHERS

È possibile utilizzare la variabile di ambiente AMQ_ALLOWED_CIPHERS per specificare un elenco personalizzato di CipherSpecs abilitati per l'utilizzo con i canali IBM MQ su Multiplatforms. La variabile di ambiente assume gli stessi valori dell'attributo della stanza AllowedCipherSpecs SSL del file .ini :

Un singolo nome CipherSpec oppure
Un elenco separato da virgole di nomi IBM MQ CipherSpec da riabilitare o
Il valore speciale di ALL, che rappresenta tutte le CipherSpecs (non consigliato).

Nota: l'abilitazione di ALL CipherSpecs non è consigliata poiché abiliterà i protocolli SSL 3.0 e TLS 1.0 e un gran numero di algoritmi di crittografia deboli.

Per ulteriori informazioni, vedi Fornisci un elenco personalizzato di CipherSpecs abilitati su Multiplatforms nell'ordine CipherSpec nell'handshake TLS.

AMQ_APP_INSTANCE_MODE

Quando AMQ_APP_INSTANCE_MODE è impostato su JVM, tutte le connessioni create da un singolo processo client Java in esecuzione in questo ambiente vengono trattate come una singola istanza di applicazione e si connettono o riconnettono allo stesso gestore di code. Vedi le istanze dell'applicazione in IBM MQ classes for JMS / Jakarta Messaging per ulteriori informazioni, comprese le restrizioni che si applicano alle applicazioni che abilitano questa modalità di funzionamento.

FDCS _DATA_BAD_AMQ_

La variabile di ambiente AMQ_BAD_COMMS_DATA_FDCS è valida quando è impostata su qualsiasi valore.

Se i dati che IBM MQ riceve da un host su TCP/IP sono in un formato non corretto, ad esempio perché un client di rete si è collegato a una porta del listener IBM MQ e ha tentato di comunicare con un protocollo dell'applicazione non supportato, il gestore code scrive un messaggio di errore AMQ9207E nei log degli errori del gestore code. I listener IBM MQ supportano le connessioni TCP/IP dagli MCA (message channel agent) del gestore code e dalle applicazioni client MQI, JMS e XMS .

Nota: i listener IBM MQ non supportano il protocollo dell'applicazione utilizzato dai client AMQP e MQTT, questi client devono invece connettersi alle porte di rete configurate nel canale AMQP o nel servizio di telemetria MQXR applicabile.

Potrebbe essere scritto anche un record FDC (failure data capture) contenente i dati non validi ricevuti da IBM MQ . Tuttavia, un file FFST non viene generato se si tratta dell'inizio di una conversazione con il lato remoto e il formato è un formato semplice e noto, come una richiesta GET da un browser web HTTP. Se si desidera sovrascrivere questo valore per far sì che i file FFST vengano scritti per qualsiasi dato non valido, inclusi i semplici formati noti, è possibile impostare la variabile di ambiente AMQ_BAD_COMMS_DATA_FDCS su qualsiasi valore (ad esempio, TRUE) e riavviare il gestore code.

AMQ_CONVBCDICNEWLINE

È possibile utilizzare la variabile di ambiente AMQ_CONVEBCDICNEWLINE per specificare come IBM MQ deve convertire un carattere EBCDIC NL in formato ASCII. La variabile di ambiente assume gli stessi valori ConvEBCDICNewline dell'attributo del mqs.ini, ovvero NL_TO_LF, TABLE o ISO (vedere la sezione Tutti i gestori di code del file mqs.ini ). È possibile, ad esempio, utilizzare la variabile di ambiente AMQ_CONVEBCDICNEWLINE invece dell'attributo della stanza ConvEBCDICNewline per fornire la funzionalità ConvEBCDICNewline sul lato client in situazioni in cui non è possibile utilizzare il file mqs.ini . Se sono impostati sia l'attributo stanza che la variabile di ambiente, l'attributo stanza ha la precedenza.

Per ulteriori informazioni, consultare Conversione dei dati tra serie di caratteri codificati .

AMQ_DIAGNOSTIC_MSG_SEVERITY

Se la variabile di ambiente AMQ_DIAGNOSTIC_MSG_SEVERITY è impostata su 1 per un processo IBM MQ , ciò fa sì che la severità del messaggio venga accodata al numero del messaggio come un singolo carattere alfabetico maiuscolo quando il processo IBM MQ scrive un messaggio in un log degli errori o nella console.

Il comportamento abilitato da AMQ_DIAGNOSTIC_MSG_SEVERITY è impostato per impostazione predefinita. Puoi disattivare questo comportamento impostando la variabile di ambiente su 0.

Per ulteriori informazioni, vedi Utilizzo dei log degli errori.

AMQ_DISABILITA_CLIENT_AMS

È possibile utilizzare la variabile di ambiente AMQ_DISABLE_CLIENT_AMS per disabilitare IBM MQ Advanced Message Security (AMS) sul client se2085 (MQRC_UNKNOWN_OBJECT_NAME)quando si tenta di connettersi a un gestore code da una versione precedente del prodotto e si sta utilizzando uno dei seguenti client:

Un Java runtime environment (JRE) diverso dal IBM Java runtime environment (JRE)
Un client IBM MQ IBM MQ classes for JMS o IBM MQ classes for Java .

Nota: non puoi utilizzare la variabile di ambiente AMQ_DISABLE_CLIENT_AMS per i client C. È necessario utilizzare la variabile di ambiente MQS_DISABLE_ALL_INTERCEPT .

Per ulteriori informazioni, consultare Disabilitazione di Advanced Message Security sul client.

AMQ_DMPMQCFG_QSGDISP_DEFAULT

Le richieste sulla disposizione di un gestore code utilizzate dal comando dmpmqcfg interrogano solo le definizioni QSGDISP (QMGR) per impostazione predefinita. È possibile richiedere ulteriori definizioni utilizzando la variabile di ambiente AMQ_DMPMQCFG_QSGDISP_DEFAULT , che può essere impostata su uno dei seguenti valori:

ATTIVO: Includere solo gli oggetti definiti con QSGDISP (QMGR) o QSGDISP (COPY).
TUTTO: Includere gli oggetti definiti con QSGDISP (QMGR) e QSGDISP (COPY). Se il gestore code è membro di un gruppo di condivisione code, vengono inclusi anche QSGDISP (GROUP) e QSGDISP (SHARED).
Copia: Includi solo, oggetti definiti con QSGDISP (COPY)
GRUPPO: Includere solo oggetti definiti con QSGDISP (GROUP); il gestore code di destinazione deve essere un membro di un gruppo di condivisione code.
QMGR: Includere solo gli oggetti definiti con QSGDISP (QMGR). Questo è il comportamento predefinito se si utilizza questa variabile di ambiente, per corrispondere al comportamento esistente di dmpmqcfg.
PRIVATO: Includere solo gli oggetti definiti con QSGDISP (QMGR) o QSGDISP (COPY).
CONDIVISO: Includere solo gli oggetti definiti con QSGDISP (SHARED).

AMQ_IODELAY, AMQ_IODELAY_INMS e AMQ_IODELAY_FFST

IBM MQ rileva quando le operazioni di lettura e scrittura del log o di input e output impiegano più tempo del previsto. Ciò potrebbe essere dovuto a problemi con il sistema operativo o il sistema di memoria e può influire sulle prestazioni del gestore code. Da IBM MQ 9.4.0, è possibile utilizzare le variabili di ambiente AMQ_IODELAY per ottimizzare la diagnostica e i tempi quando l'input e l'output per il log del gestore code e il file system di archiviazione sono lenti. Se viene visualizzato il messaggio AMQ6729WLog I/O operation exceeded thresholdnel log degli errori del gestore code, esaminare la causa e apportare le modifiche di conseguenza. Utilizzare le variabili come mostrato nei seguenti esempi:

MQ_IODELAY

Tempo di soglia in secondi, il valore predefinito è 1 secondo. Se un'operazione I/O impiega più tempo di questa soglia, nei file di log di IBM MQ viene riportato il messaggio di errore AMQ6729W . Il messaggio di avvertenza viene ripetuto al massimo ogni 10 secondi se i ritardi continuano. È possibile aumentare questo valore per eliminare gli errori o diminuire per esaminare specifici problemi di prestazioni. Ad esempio:

export AMQ_IODELAY=200000

INM_AMQ_IODELAY_INM

Modificare la misura temporale in microsecondi invece che in secondi. Utilizzare questa opzione per impostare una soglia inferiore prima di ricevere il messaggio AMQ6729 nel log del gestore code.

export AMQ_IODELAY_INMS=YES

AMQ_IODELAY_FFST

Oltre al messaggio di avvertenza nel log degli errori, ogni volta che viene superata la soglia viene generato un file FFST contenente informazioni diagnostiche.

export AMQ_IODELAY_FFST=YES

L'avvio del gestore code come in questo esempio, causa la scrittura di un file FDC o FFST se un'operazione di input / output impiega più di 200000 microsecondi (0.2s), che è ancora una soglia relativamente generosa.

Per ulteriori informazioni, fare riferimento alla sezione Funzionamento del controllo di integrità del gestore code.

TRACCIA AMQ_LDAP_

Se la variabile di ambiente AMQ_LDAP_TRACE è impostata su un valore non null, è possibile attivare e disattivare la traccia del client LDAP senza arrestare o avviare anche il gestore code.

Per ulteriori informazioni, consultare Abilitazione della traccia dinamica del codice della libreria client LDAP.

METRICA_LICENZA_AMQ

L'impostazione della variabile di ambiente AMQ_LICENSING_METRIC=VPCMonthlyPeak fa in modo che il gestore code carichi i dati relativi a tipi di licenza VPC mensili, invece del comportamento predefinito di caricamento dei dati relativi alle licenze orarie basate sul contenitore.

Per ulteriori informazioni sulla configurazione di 'IBM MQ da utilizzare con il servizio di misurazione 'IBM Cloud® Private, vedere il servizio di misurazione 'IBM Cloud Private nella documentazione di 'IBM Cloud Private.

MQ_MQS_INI_LOCATION

Su sistemi AIX and Linux , è possibile modificare l'ubicazione utilizzata per il file mqs.ini impostando l'ubicazione del file mqs.ini nella variabile di ambiente AMQ_MQS_INI_LOCATION . Questa variabile di ambiente deve essere impostata a livello di sistema.

Per ulteriori informazioni sul file mqs.ini , comprese le posizioni delle directory, consultare IBM MQ file di configurazione, mqs.ini.

FDCS - NO_AMQ_BAD_COMMS_DATA_

La variabile di ambiente AMQ_NO_BAD_COMMS_DATA_FDCS è valida quando è impostata su qualsiasi valore.

Se IBM MQ non riconosce la trasmissione dati iniziale durante il tentativo di connessione di un client nonIBM MQ a un listener TCP/IP IBM MQ , il gestore code scrive un messaggio di errore AMQ9207E nei log degli errori del gestore code. Viene scritto anche un record FDC (failure data capture). È possibile sopprimere la generazione di questi file di diagnostica con la variabile di ambiente AMQ_NO_BAD_COMMS_DATA_FDCS . Quando AMQ_NO_BAD_COMMS_DATA_FDCS è impostato su un valore (ad esempio, TRUE), questo indica a IBM MQ di non generare FFST quando si riportano i messaggi di errore AMQ9207E sul flusso di comunicazioni iniziale. Per essere efficace, la variabile di ambiente deve essere impostata prima di avviare i processi del gestore code e del listener.

L'FDC continua ad essere generato nel caso in cui un client invii flussi di protocollo IBM MQ validi al gestore code e quindi invii dati non validi, poiché ciò è indicativo di un problema del client che richiede ulteriori indagini.

Nota: l'acquisizione di FFST durante la notifica dei messaggi di errore AMQ9207E sui flussi di comunicazione iniziali viene eliminata per impostazione predefinita.

AMQ_NO_IPV6

La variabile di ambiente AMQ_NO_IPV6 è valida quando è impostata su qualsiasi valore. Quando questa variabile di ambiente è impostata, disabilita l'uso di IPv6 durante il tentativo di connessione.

ORDINE_ANNULLAMENTO_COMMIT

La variabile di ambiente AMQ_REVERSE_COMMIT_ORDER configura un gestore code in modo che in una transazione XA venga eseguito il commit della modifica del gestore code IBM MQ una volta completato l'aggiornamento del corrispondente database. Le applicazioni che leggono i messaggi dalle code visualizzano un messaggio solo dopo che è stato completato l'aggiornamento del database corrispondente.

Nota: non impostare AMQ_REVERSE_COMMIT_ORDER senza leggere e comprendere lo scenario descritto in Livello di isolamento.

AMQ_RDQM_NO_PING_CHECKS

Quando è impostata la variabile d'ambiente AMQ_RDQM_NO_PING_CHECKS , i ping ICMP sono disabilitati in una configurazione RDQM. RDQM utilizza i pacchetti ping ICMP per verificare le connessioni remote durante la configurazione di pacemaker e la creazione di gestori di code. Per impostazione predefinita, questa variabile d'ambiente non viene rispettata da un utente non root con privilegi sudo. Impostate AMQ_RDQM_NO_PING_CHECKS ed eseguite i comandi di installazione e configurazione come root, oppure aggiornate le regole di sudoers per includere la variabile d'ambiente.

AMQ_SSL_CONSENTI_CERTIFICATO_PREDEFINITO

Quando la variabile di ambiente AMQ_SSL_ALLOW_DEFAULT_CERT non è impostata, un'applicazione può connettersi a un gestore code con un certificato personale nel keystore client solo quando il certificato include il nome etichetta ibmwebspheremquserid. Quando la variabile di ambiente AMQ_SSL_ALLOW_DEFAULT_CERT è impostata, il certificato non richiede il nome etichetta ibmwebspheremquserid. In altre parole, il certificato utilizzato per connettersi a un gestore code può essere un certificato predefinito, purché sia presente un certificato predefinito nel repository delle chiavi e il repository delle chiavi non contenga un certificato personale con prefisso ibmwebspheremquserid.

Un valore di 1 abilita l'utilizzo di un certificato predefinito.

Invece di utilizzare la variabile di ambiente AMQ_SSL_ALLOW_DEFAULT_CERT , un'applicazione può utilizzare l'impostazione CertificateLabel della stanza SSL nel file mqclient.ini . Per ulteriori informazioni, consultare Etichette dei certificati digitali, comprensione dei requisiti e sezione SSL del file di configurazione del client.

AMQ_SSL_LDAP_SERVER_VERSION

La variabile di ambiente AMQ_SSL_LDAP_SERVER_VERSION può essere utilizzata per garantire che LDAP v2 o LDAP v3 venga utilizzato dai componenti crittografici IBM MQ nei casi in cui i server CRL richiedono l'utilizzo di una versione specifica del protocollo LDAP.

Impostare la variabile di ambiente sul valore appropriato nell'ambiente utilizzato per avviare il gestore code o il canale:

Per richiedere l'utilizzo di LDAP v2 , impostare AMQ_SSL_LDAP_SERVER_VERSION=2.
Per richiedere l'utilizzo di LDAP v3 , impostare AMQ_SSL_LDAP_SERVER_VERSION=3.

Questa variabile di ambiente non influisce sulle connessioni LDAP stabilite dal gestore code IBM MQ per l'autenticazione utente o l'autorizzazione utente.

AMQ_TLS_AMBIENTE_AMBITO

È possibile utilizzare la variabile AMQ_TLS_ENVIRONMENT_SCOPE di ambiente per controllare se IBM MQ utilizza un unico IBM Global Security Kit (GSKit) ambiente per l'intero processo o un IBM Global Security Kit (GSKit) ambiente per ogni connessione. La variabile di ambiente assume gli stessi valori EnvironmentScope dell'attributo del mqclient.ini, ovvero PROCESS o CONNECTION (vedere la sezione SSL del file di configurazione del client ). L'impostazione di questa variabile d'ambiente influisce sul momento in cui le modifiche all'archivio chiavi TLS vengono rilevate dalle applicazioni client. L'impostazione CONNECTION significa che le modifiche all'archivio chiavi TLS vengono rilevate ad ogni connessione avviata dall'applicazione, con un conseguente aumento dell'utilizzo della memoria e della CPU.

ZLIBNX UTENTE AMQ_

Su AIX, la variabile di ambiente AMQ_USE_ZLIBNX può essere utilizzata per abilitare gli agent MCA (message channel agent) per utilizzare la libreria zlibNX accelerata dall'hardware per la compressione e la decompressione dei dati del messaggio quando si utilizzano le tecniche ZLIBFAST o ZLIBHIGH.

Suggerimento: è più probabile che i messaggi altamente comprimibili di dimensione superiore a 2 KB traggano vantaggio dalla scelta di utilizzare la libreria zlibNX , riducendo l'uso della CPU.

La libreria zlibNX è disponibile in IBM AIX 7.2 con Technology Level 4 Expansion Pack e versioni successive. Se la variabile di ambiente è impostata e la libreria zlibNX (/usr/opt/zlibNX/lib/libz.a) non viene installata, gli agent del canale dei messaggi utilizzeranno la libreria zlib standard fornita nell'installazione di IBM MQ for AIX .

HOME

In AIX, Linux e IBM i, la variabile di ambiente HOME specifica il nome della directory in cui viene ricercato il file mqclient.ini . Questo file contiene informazioni di configurazione utilizzate da IBM MQ MQI clients.

Per ulteriori informazioni, vedere IBM MQ File di configurazione client MQI, mqclient.ini e Posizione del file di configurazione client.

HOMEDRIVE e HOMEPATH

Per essere utilizzate, devono essere impostate sia le variabili di ambiente HOMEDRIVE che HOMEPATH . Vengono utilizzati su sistemi Windows per specificare il nome della directory in cui viene ricercato il file mqclient.ini . Questo file contiene informazioni di configurazione utilizzate da IBM MQ MQI clients.

Per ulteriori informazioni, consultare IBM MQ File di configurazione client MQI, mqclient.ini e Posizione del file di configurazione client.

LDAP_BASEDN

LDAP_BASEDN è la variabile di ambiente richiesta per l'esecuzione di un programma di esempio LDAP. Specifica il DN (Distinguished Name) di base per la ricerca nell'indirizzario.

HOST_LDAP

LDAP_HOST è una variabile di ambiente facoltativa per l'esecuzione di un programma di esempio LDAP. Specifica il nome dell'host su cui è in esecuzione il server LDAP; se non viene specificato, viene utilizzato per impostazione predefinita l'host locale.

VERSIONE LDAP

LDAP_VERSION è una variabile di ambiente facoltativa per l'esecuzione di un programma di esempio LDAP. Specifica la versione del protocollo LDAP da utilizzare e può essere 2 o 3. La maggior parte dei server LDAP ora supporta la versione 3 del protocollo; tutti supportano la versione precedente 2. Questo esempio funziona ugualmente bene con entrambe le versioni del protocollo e, se non viene specificato, il valore predefinito è la versione 2.

MQCCDTCERTVPOL

MQCCDTCERTVPOL è una variabile d'ambiente opzionale per la politica di convalida dei certificati CCDT che può essere configurata per la IBM MQ classes for JMS libreria client. È possibile utilizzare MQCCDTCERTVPOL per applicare il livello di convalida richiesto per il recupero CCDT su una connessione HTTPS, specificando uno dei seguenti valori:

ANY: Verifica che il certificato del peer sia valido, firmato da un'autorità attendibile, e ignora la verifica del nome host. Se viene fornito un SSLSocketFactory personalizzato, questo sostituisce il meccanismo predefinito di Java Secure Socket Extension (JSSE).
Nessuna: Tutti i certificati server vengono accettati senza convalida. Verrà utilizzata un'implementazione interna dell'handler che fornisce un'istanza SSLSocketFactory che considera attendibili tutti i certificati. Se viene fornito un SSLSocketFactory personalizzato, esso sostituisce l'implementazione dell'handler.
HOSTNAMECN: Verifica che il certificato del peer sia valido, firmato da un'autorità attendibile e che il nome distinto del certificato (comprese le estensioni CN e SAN) corrisponda a quello del server HTTP contattato. Se viene fornito un SSLSocketFactory personalizzato, questo sostituisce il meccanismo predefinito di JSSE.

Per ulteriori informazioni, vedere Configurazione delle politiche di convalida dei certificati in IBM MQ.

INTERVALLO_ELIMINAZIONE_CANALE_MQ

La variabile di ambiente MQ_CHANNEL_SUPPRESS_INTERVAL specifica l'intervallo di tempo, in secondi, durante il quale i messaggi definiti con MQ_CHANNEL_SUPPRESS_MSGS devono essere eliminati dalla scrittura nel log degli errori, insieme al numero di volte in cui un messaggio può verificarsi durante l'intervallo di tempo specificato prima di essere eliminato. Il valore predefinito è 60,5, il che significa che ogni ulteriore ricorrenza di un determinato messaggio viene soppressa dopo le prime cinque ricorrenze di tale messaggio in un intervallo di 60 secondi. Per ulteriori informazioni, consultare Soppressione dei messaggi di errore del canale dai log degli errori su Multiplatforms.

La variabile MQ_CHANNEL_SUPPRESS_INTERVAL di ambiente è paragonabile a SuppressInterval nel qm.ini file.

MQ_CHANNEL_SUPPRESS_MSGS

La variabile di ambiente MQ_CHANNEL_SUPPRESS_MSGS elimina i messaggi di errore del canale nel log degli errori. È possibile specificare un elenco di messaggi eliminati. MQ_CHANNEL_SUPPRESS_MSGS viene utilizzato insieme a MQ_CHANNEL_SUPPRESS_INTERVAL, che specifica il numero di volte in cui ogni messaggio viene visualizzato prima di essere eliminato e l'intervallo di tempo per cui i messaggi vengono eliminati. Per ulteriori informazioni, consultare Soppressione dei messaggi di errore del canale dai log degli errori su Multiplatforms.

La variabile MQ_CHANNEL_SUPPRESS_MSGS di ambiente è paragonabile a SuppressMessage nel qm.ini file, tranne per il fatto che è possibile sopprimere qualsiasi messaggio del canale utilizzando la variabile di ambiente, mentre esiste un elenco restrittivo per il qm.ini metodo.

TIPO_MQ_CONNECT

Su Multiplatforms, è possibile utilizzare la variabile d'ambiente MQ_CONNECT_TYPE in combinazione con il tipo di collegamento specificato nel campo Opzioni della struttura MQCNO utilizzata su una chiamata MQCONNX. MQ_CONNECT_TYPE ha effetto solo per i bind STANDARD. Per altri bind, MQ_CONNECT_TYPE viene ignorato.

Per ulteriori informazioni, consultare Utilizzo delle opzioni di chiamata MQCONNX con MQ_CONNECT_TYPE.

MQ_CROSS_QUEUE_ORDER_ALL

Quando si imposta la variabile di ambiente MQ_CROSS_QUEUE_ORDER_ALL su un valore diverso da zero, l'ordine di inserimento del messaggio viene conservato in un'unità di lavoro. Ciò significa che, se i messaggi in una UOW (Unit of Work) (UoW) vengono inseriti in più code (ad esempio, Q1, quindi Q2), quando viene emesso un MQCMIT, i messaggi vengono consegnati e resi disponibili nello stesso ordine della coda in cui erano PUT.

In un ambiente con più gestori code, MQ_CROSS_QUEUE_ORDER_ALL deve esistere e avere un valore non vuoto sia sul lato di invio che su quello di ricezione prima che ogni gestore code venga avviato.

MQ_EPHEMER_PREFIX

La variabile di ambiente MQ_EPHEMERAL_PREFIX specifica il percorso della directory temporanea del gestore code, all'interno della quale vengono conservati i dati del gestore code temporaneo, mentre il gestore code è in esecuzione.

In alternativa alla modifica del prefisso effimero modificando EphemeralPrefix l'attributo DefaultEphemeralPrefix nell'attributo della stanza AllQueueManagers del mqs.ini file, è possibile utilizzare la variabile di ambiente MQ_EPHEMERAL_PREFIX per sovrascrivere il EphemeralPrefix per il crtmqm comando. Per ulteriori informazioni, vedere Directory effimera configurabile.

PERCORSO MQ_FILE

La variabile di ambiente MQ_FILE_PATH viene configurata durante l'installazione del pacchetti di runtime sulla piattaforma Windows . Questa variabile di ambiente contiene gli stessi dati della seguente chiave nel registro Windows :

HKEY_LOCAL_MACHINE\SOFTWARE\IBM\WebSphere MQ\Installation\InstallationName\FilePath

Per ulteriori informazioni, consultare setmqenv (set IBM MQ environment) e crtmqenv (create IBM MQ environment).

MQ_JAVA_DATA_PATH

La variabile di ambiente MQ_JAVA_DATA_PATH specifica la directory per l'output di log e traccia per IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaging e IBM MQ classes for Java. Viene utilizzato dagli script forniti con IBM MQ classes for JMS e con IBM MQ classes for Jakarta Messaging e IBM MQ classes for Java.

Per ulteriori informazioni, consultare Impostazione delle variabili di ambiente per le classi IBM MQ per JMS/Jakarta Messaging e Variabili di ambiente relative alle classi IBM MQ per Java.

PERCORSO_INSTALL_JAVA_MQ_

La variabile di ambiente MQ_JAVA_INSTALL_PATH specifica la directory in cui sono installati IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaging come mostrato in Elementi installati per le classi IBM MQ per JMSe IBM MQ classes for Java come mostrato in Directory di installazione IBM MQ classes for Java .

Per ulteriori informazioni, consultare Impostazione delle variabili di ambiente per le classi IBM MQ per JMS/Jakarta Messaging e Variabili di ambiente relative alle classi IBM MQ per Java.

MQ_JAVA_LIB_PATH

La variabile di ambiente MQ_JAVA_LIB_PATH specifica la directory in cui sono memorizzate IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaginge le librerie IBM MQ classes for Java . Alcuni script, ad esempio, IVTRun, forniti con IBM MQ classes for JMS e IBM MQ classes for Jakarta Messaging o IBM MQ classes for Java utilizzano questa variabile di ambiente.

Per ulteriori informazioni, consultare Impostazione delle variabili di ambiente per le classi IBM MQ per JMS/Jakarta Messaging e Variabili di ambiente relative alle classi IBM MQ per Java.

MQ_LCLADDR

Sulle multipiattaforme, è possibile impostare la variabile d'ambiente MQ_LCLADDR per definire un valore di indirizzo locale predefinito che viene utilizzato per tutti i canali mittente che non hanno un indirizzo locale definito. Il valore predefinito viene definito impostando la variabile d'ambiente MQ_LCLADDR prima di avviare il gestore di code. Il formato del valore deve corrispondere a quello dell'attributo MQSC LOCLADDR. Per ulteriori informazioni, vedere LOCLADDR (Indirizzo locale) e Utilizzo dei canali cluster-sender definiti automaticamente.

MQ_OVERRIDE_DATA_PATH

È possibile utilizzare la variabile di ambiente MQ_OVERRIDE_DATA_PATH per modificare la directory predefinita del percorso dati IBM MQ .

MQ_SET_NODELAYACK

La variabile di ambiente MQ_SET_NODELAYACK disattiva il riconoscimento ritardato TCP su AIX.

Quando si imposta questa variabile di ambiente, l'impostazione disattiva la ricezione ritardata TCP richiamando la chiamata setsockopt del sistema operativo con l'opzione TCP_NODELAYACK . Solo AIX supporta questa funzione, quindi la variabile di ambiente MQ_SET_NODELAYACK ha effetto solo su AIX.

MQ_XX_ENCODE_CASE_ONE nome_utente

Se l'utente non ha una password o ha un nome che corrisponde al suo identificatore utente, si può usare la variabile d'ambiente MQ_USER_NAME per consentire a un'immagine non installata di IBM MQ su Linux di scegliere il nome utente. Questo è necessario, ad esempio, per utilizzare le gerarchie publish/subscribe in OpenShift.

Il valore di MQ_USER_NAME non deve corrispondere a un utente preesistente sul sistema e deve essere inferiore o uguale a 12 byte.

LOGFILE MQAPI_TRACE_

Il programma di uscita API di esempio genera una traccia MQI per un file specificato dall'utente con un prefisso che è definito nella variabile di ambiente MQAPI_TRACE_LOGFILE .

Per ulteriori informazioni, consultare Il programma di esempio dell'uscita API.

NOME MQAPPL

Se il nome dell'applicazione non è stato ancora scelto, è possibile utilizzare la variabile di ambiente MQAPPLNAME come nome da utilizzare per identificare la connessione a un gestore code. Vengono utilizzati solo i primi 28 caratteri e non devono essere tutti spazi o valori null.

Per ulteriori informazioni, consultare Utilizzo del nome applicazione nei linguaggi di programmazione supportati.

MQCCSID

La variabile di ambiente MQCCSID specifica il numero della serie di caratteri codificati da utilizzare e sostituisce il valore CCSID con cui è stato configurato il server. MQCCSID può essere utilizzato per sovrascrivere il CCSID nativo di un'applicazione e specificare il numero della serie di caratteri codificati da utilizzare, ad esempio se il CCSID nativo è un CCSID non supportato o non è il CCSID richiesto.

Per impostare MQCCSID, utilizzare uno dei seguenti comandi:

Su AIX and Linux:
```
export MQCCSID=number
```
Su Windows:
```
SET MQCCSID=number
```

Su IBM i:

ADDENVVAR ENVVAR(MQCCSID) VALUE(number)

Per ulteriori informazioni, consultare Scelta del CCSID del client o del server.

URL MQCCDT

La variabile di ambiente MQCCDTURL fornisce la capacità equivalente di impostare una combinazione delle variabili di ambiente MQCHLLIB e MQCHLTAB . Usare questa variabile per fornire un file, ftp, o http URL come singolo valore da cui si può ottenere una tabella di definizione dei canali client per i programmi nativi (applicazioni C, COBOL, o C++) che si connettono come client. MQ 9.4.1 Oct 2024]

Da IBM MQ 9.4.1, sono https supportati anche gli URL.

Note:

L'uso di variabili d'ambiente per fornire l' URL non ha effetto per le applicazioni Java, JMS o .NET gestite.
La lunghezza massima dell' URL corrisponde alla lunghezza massima del percorso del file del sistema operativo.

IBM MQ supporta il recupero di un CCDT da un file, ftp o http URL. MQ 9.4.1 Oct 2024] oppure, da IBM MQ 9.4.1, un https URL Tuttavia, 'MQCCDTURL non accetta un valore FTP. Accetta solo un valore URL o un file specificato tramite il protocollo "file://".

Ad esempio, quando si utilizza 'MQCCDTURL al posto di 'MQCHLLIB e 'MQCHLTAB con un file locale su 'AIX e 'Linux, questo comando:

export MQCCDTURL=file:///var/mqm/qmgrs/QMGR/@ipcc/MYCHL.TAB

equivale a:

export MQCHLLIB=/var/mqm/qmgrs/QMGR/@ipcc
export MQCHLTAB=MYCHL.TAB

Puoi specificare anche un file JSON come mostrato in questo esempio per Windows:

set MQCCDTURL=file:/c:/mq-channels/CCDT-QMGR1.json

equivale a:

set MQCHLLIB=C:\mq-channels
set MQCHLTAB=CCDT-QMGR1.json

Per ulteriori informazioni, consultare URL accesso al CCDT.

MQCERTLABL

La variabile di ambiente di MQCERTLABL definisce l'etichetta del certificato di una definizione di canale che IBM MQ deve utilizzare per individuare un certificato personale inviato durante un handshake TLS.

Per ulteriori informazioni, consultare Etichette di certificati digitali, che comprendono i requisiti.

MQCERTVPOL

La variabile di ambiente MQCERTVPOL specifica il tipo di politica di convalida del certificato da utilizzare. Questa variabile di ambiente sovrascrive l'attributo CertificateValPolicy nella stanza SSL del file di configurazione client.

MQCERTVPOL può essere impostato su uno dei seguenti valori:

ANY: Utilizzare qualsiasi politica di convalida del certificato supportata dalla libreria dei socket protetti sottostante. Questa è l'impostazione predefinita.
RFC5280: Utilizzare solo la convalida del certificato conforme allo standard RFC 5280.
NESSUNO: Non utilizzare alcun criterio di convalida dei certificati. Questa impostazione è riservata alle applicazioni client.

Per impostare MQCERTVPOL, utilizzare uno dei seguenti comandi:

Per AIX and Linux i sistemi:
```
export MQCERTVPOL= value
```
Per Windows i sistemi:
```
SET MQCERTVPOL= value
```

Per IBM i i sistemi:

ADDENVVAR ENVVAR(MQCERTVPOL) VALUE(value)

Per ulteriori informazioni, consulta Certificate validation policies in IBM MQ e Configuring certificate validation policies in IBM MQ.

MQCHLLIB

La variabile di ambiente MQCHLLIB specifica il percorso di directory del file che contiene la CCDT (client channel definition table). Il file viene creato sul server, ma può essere copiato sulla workstation IBM MQ MQI client .

Per impostare MQCHLLIB, utilizzare uno dei seguenti comandi:

Su Windows:

SET MQCHLLIB=pathname

Ad esempio:

SET MQCHLLIB=C:\wmqtest

Per AIX and Linux i sistemi:
```
export MQCHLLIB=pathname
```

Per IBM i:

ADDENVVAR ENVVAR(MQCHLLIB) VALUE(pathname)

Se MQCHLLIB non è impostato, il percorso per il client assume il valore predefinito:

Su AIX and Linux: /var/mqm/
Su Windows: MQ_INSTALLATION_PATH
Su IBM i: /QIBM/UserData/mqm/

Per i comandi crtmqm e strmqm , il percorso assume il valore predefinito di una delle due serie di percorsi. Se datapath è impostato, il valore predefinito del percorso è uno della prima serie. Se datapath non è impostato, il percorso assume il valore predefinito di uno della seconda serie.

Su AIX and Linux: datapath/@ipcc
Su Windows: datapath\@ipcc
Su IBM i: datapath/&ipcc

Su AIX and Linux: /prefix/qmgrs/qmgrname/@ipcc
Su Windows: MQ_INSTALLATION_PATH\data\qmgrs\qmgrname\@ipcc
Su IBM i: /prefix/qmgrs/qmgrname/&ipcc

dove:

MQ_INSTALLATION_PATH rappresenta la directory di alto livello in cui è installato IBM MQ .
Se presente, datapath è il valore di DataPath definito nella stanza del gestore code.
prefix è il valore del prefisso definito nella stanza del gestore code. Il prefisso è di solito uno dei seguenti valori:
- /var/mqm sui AIX and Linux sistemi.
- /QIBM/UserData/mqm/ su IBM i.
qmgrname è il valore dell'attributo Directory definito nella stanza del gestore code. Il valore potrebbe essere diverso dal nome del gestore code effettivo. Il valore potrebbe essere stato modificato per sostituire i caratteri speciali.
La posizione in cui è definita la sezione del gestore code dipende dalla piattaforma:
- Nel mqs.ini file su IBM i, AIX and Linux.
- Nel registro su Windows.

Note:

Se si utilizza IBM MQ for z/OS® come server, il file deve essere conservato sulla workstation IBM MQ client.
Se impostato, MQCHLLIB sovrascrive il percorso utilizzato per individuare la CCDT.
MQCHLLIB può contenere un URL e che funziona in combinazione con la variabile di ambiente MQCHLTAB (vedere URL accesso al CCDT ).
Le variabili di ambiente, come ad esempio MQCHLLIB, possono essere indirizzate a un processo o a un lavoro o a livello di sistema, in un modo specifico per la piattaforma.
Se si imposta MQCHLLIB a livello di sistema su un server, questo imposta lo stesso percorso al file CCDT per tutti i gestori code sul server. Se non si imposta la variabile di ambiente MQCHLLIB , il percorso è diverso per ciascun gestore code. I gestori code leggono il valore di MQCHLLIB, se impostato, sul comando crtmqm o strmqm .
Se si creano più gestori code su un server, la distinzione è importante, per il seguente motivo. Se si imposta MQCHLLIB a livello di sistema, ogni gestore code aggiorna lo stesso file CCDT. Il file contiene le definizioni di connessione client da tutti i gestori code sul server. Se la stessa definizione esiste su più gestori code, ad esempio SYSTEM.DEF.CLNTCONN , il file contiene la definizione più recente. Quando si crea un gestore code, se MQCHLLIB è impostato, SYSTEM.DEF.CLNTCONN viene aggiornato in CCDT. L'aggiornamento sovrascrive il SYSTEM.DEF.CLNTCONN creato da un gestore code differente. Se è stata modificata la definizione precedente, le modifiche vengono perse. Per questo motivo, è necessario considerare la ricerca di alternative all'impostazione di MQCHLLIB come variabile di ambiente a livello di sistema sul server.
L'opzione NOREPLACE MQSC e PCF su una definizione di connessione client non controlla il contenuto del file CCDT. Una definizione di canale di connessione client con lo stesso nome precedentemente creato, ma non da questo gestore code, viene sostituita, indipendentemente dall'opzione NOREPLACE . Se la definizione è stata precedentemente creata dallo stesso gestore code, la definizione non viene sostituita.
Il comando rcrmqobj -t clchltab elimina e ricrea il file CCDT. Il file viene ricreato solo con le definizioni di connessioni client create sul gestore code su cui è in esecuzione il comando.
Altri comandi che aggiornano CCDT modificano solo i canali di connessione client che hanno lo stesso nome di canale. Altri canali di connessione client nel file non vengono modificati.
Il percorso per MQCHLLIB non necessita di virgolette.

Per ulteriori informazioni, consultare Posizioni del CCDT, Accesso al CCDT tramite l' URL e Collegamento delle applicazioni client ai gestori di code tramite variabili di ambiente.

MQCHLTAB

La variabile di ambiente MQCHLTAB specifica il nome del file che contiene la CCDT (client channel definition table). Il nome file predefinito è AMQCLCHL.TAB.

Per impostare MQCHLTAB, utilizzare uno dei seguenti comandi:

Su AIX and Linux:
```
export MQCHLTAB=filename
```
Su Windows:
```
SET MQCHLTAB=filename
```

Su IBM i:

ADDENVVAR ENVVAR(MQCHLTAB) VALUE(filename)

Ad esempio:

SET MQCHLTAB=ccdf1.tab

Come per il client, la variabile di ambiente MQCHLTAB sul server specifica il nome della tabella di definizione del canale client.

Per ulteriori informazioni, consultare Posizioni del CCDT, Accesso al CCDT tramite l' URL e Collegamento delle applicazioni client ai gestori di code tramite variabili di ambiente.

MQCLNTCF

La variabile di ambiente MQCLNTCF specifica l'ubicazione del file di configurazione IBM MQ MQI client . Questo file contiene informazioni di configurazione utilizzate da IBM MQ MQI clients.

Di seguito sono elencati alcuni esempi di formati validi. È possibile scegliere un nome file diverso da mqclient.ini. È possibile scegliere qualsiasi percorso valido sul proprio sistema che sia leggibile dal client durante l'esecuzione.

Questi sono esempi di impostazioni valide per MQCLNTCF sui AIX and Linux sistemi quando il file si trova in /data/mqclient.ini.

export MQCLNTCF=/data/mqclient.ini
export MQCLNTCF=file:/data/mqclient.ini
export MQCLNTCF=file:////data/mqclient.ini
export MQCLNTCF=file://localhost//data/mqclient.ini

Questi sono esempi di impostazioni valide per MQCLNTCF sui Windows sistemi quando il file si trova in C:\data\mqclient.ini.

set MQCLNTCF=C:\data\mqclient.ini
set MQCLNTCF=file:C:\data\mqclient.ini
set MQCLNTCF=file:///C:\data\mqclient.ini
set MQCLNTCF=file://localhost/C:\data\mqclient.ini

[z/OS] La z/OS piattaforma non può essere utilizzata per eseguire IBM MQ client. Pertanto, il mqclient.ini file non esiste su IBM MQ for z/OS.

Per ulteriori informazioni, consultare IBM MQ File di configurazione client MQI, mqclient.ini e Posizione del file di configurazione client.

TRACE_MQDOTNET_ATTIVO

La variabile di ambiente MQDOTNET_TRACE_ON viene utilizzata per abilitare la traccia per client IBM MQ .NET ridistribuibili. I valori uguali e inferiori a 0 non abilitano la traccia, 1 abilita la traccia predefinita e i valori superiori a 1 abilitano la traccia dei dettagli.

Per ulteriori informazioni, consultare Traccia delle applicazioni IBM MQ .NET e Traccia delle applicazioni IBM MQ .NET utilizzando le variabili di ambiente.

MQIPADRV

La variabile di ambiente MQIPADDRV specifica quale protocollo IP utilizzare per una connessione del canale. Ha i valori stringa possibili di "MQIPADDR_IPV4" o "MQIPADDR_IPV6". Questi valori hanno lo stesso significato di IPv4 e IPv6 in ALTER QMGR IPADDRV e l'attributo IPAddressVersion della stanza TCP del file di configurazione client. Se la variabile di ambiente non è impostata, viene utilizzato "MQIPADDR_IPV4" .

Per impostare MQIPADDRV, utilizzare uno dei seguenti comandi:

Su AIX and Linux:

export MQIPADDRV=MQIPADDR_IPV4|MQIPADDR_IPV6"/>

Su Windows:

SET MQIPADDRV=MQIPADDR_IPV4|MQIPADDR_IPV6

Su IBM i:

ADDENVVAR ENVVAR(MQIPADDRV) VALUE(MQIPADDR_IPV4|MQIPADDR_IPV6)

MQKEYRPWD

Quando imposti ilMQKEYRPWD variabile d'ambiente, specifica la password per il repository di chiavi che contiene il certificato digitale appartenente all'utente. SeMQKEYRPWD viene utilizzato, è necessario crittografare la password prima di impostare il valore della variabile di ambiente.

Per impostare MQKEYRPWD, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQKEYRPWD=passphrase
```
Sui Windows sistemi:
```
SET MQKEYRPWD=passphrase
```

Su IBM i:

ADDENVVAR ENVVAR(MQKEYRPWD) VALUE(passphrase)

Non esiste alcun valore predefinito per questa variabile di ambiente.

Per ulteriori informazioni, fai riferimento a

MQLICENSE

Sui sistemi Linux , è possibile utilizzare la variabile di ambiente MQLICENSE per accettare o visualizzare una licenza IBM MQ dopo aver installato il prodotto.

Per ulteriori informazioni sui motivi per cui si desidera o è necessario accettare la licenza dopo l'installazione, vedere Accettazione della licenza su IBM MQ per Linux.

Importante: se si utilizza la variabile d'ambiente MQLICENSE per accettare o visualizzare una licenza IBM MQ dopo l'installazione del prodotto, tenere presente i seguenti punti:

L'accettazione della licenza tramite l'impostazione della variabile d'ambiente MQLICENSE è valida solo per la sessione corrente.
L'esecuzione del comando dspmqver mostra ancora la licenza come non accettata se lo si esegue dopo aver accettato la licenza impostando la variabile d'ambiente MQLICENSE .

La variabile di ambiente MQLICENSE può essere impostata su uno dei due seguenti valori:

accettare

Accettare la licenza post - installazione.

Per accettare la post - installazione della licenza, utilizzare questo comando:

export MQLICENSE=accept

vista

Visualizzare la licenza, se la licenza è stata accettata.

Per visualizzare la licenza, utilizzare questo comando:

export MQLICENSE=view

Nota: è anche possibile utilizzare i seguenti comandi per accettare e visualizzare la licenza:

DIMENSIONE MQMAXERRORLOGSIZE

La variabile di ambiente MQMAXERRORLOGSIZE specifica la dimensione del file di log degli errori del gestore code copiato nel backup.

Per ulteriori informazioni, vedi Utilizzo dei log degli errori.

NOME

La variabile di ambiente MQNAME specifica il nome NetBIOS locale che i processi IBM MQ possono utilizzare. Una connessione NetBIOS si applica solo a un client e a un server su cui è in esecuzione Windows.

Per impostare MQNAME, utilizzare questo comando:

SET MQNAME=Your_env_Name

Ad esempio:

SET MQNAME=CLIENT1

Alcune implementazioni NetBIOS richiedono un nome univoco, impostato da MQNAME, per ogni applicazione se si eseguono più applicazioni IBM MQ contemporaneamente su IBM MQ MQI client.

Per ulteriori informazioni, vedere Definizione dell' IBM MQ local NetBIOS name.

MQNOREMPOOL

Quando si imposta la variabile di ambiente MQNOREMPOOL , si disattiva il pool di canali e i canali vengono eseguiti come thread del listener.

Per ulteriori informazioni, fare riferimento a MCATYPE (Message channel agent type).

LOGFILE MQPSE_TRACE_

Si utilizza la variabile di ambiente MQPSE_TRACE_LOGFILE quando si esegue il programma di esempio di uscita di pubblicazione AMQSPSE0, che è un esempio di programma C di un'uscita per intercettare una pubblicazione prima che venga consegnata a un sottoscrittore. Nel processo dell'applicazione da tracciare, questa variabile di ambiente descrive dove devono essere scritti i file di traccia.

Per ulteriori informazioni, consultare Programma di esempio Pubblica uscita.

MQS_AMSCRED_XX_ENCODE_CASE_ONE file_chiave

È possibile utilizzare la variabile di ambiente MQS_AMSCRED_KEYFILE per sovrascrivere o fornire il file di chiavi iniziale da utilizzare al runtime delle applicazioni IBM MQ Advanced Message Security (AMS) o quando si sta proteggendo un file di configurazione keystore utilizzando il comando runamscred .

Per ulteriori informazioni, consultare Utilizzo di keystore e certificati con AMS e Protezione delle password nei file di configurazione del componente IBM MQ.

MQS_DISABILITA_TUTTE_LE_INTERCETTAZIONI

È possibile utilizzare la variabile di ambiente MQS_DISABLE_ALL_INTERCEPT per disabilitare IBM MQ Advanced Message Security (AMS) se2085 (MQRC_UNKNOWN_OBJECT_NAME)L'errore viene riportato quando si tenta di connettersi a un gestore code da una versione precedente del prodotto e si utilizza IBM MQ con client C nativi.

Nota: è possibile utilizzare la variabile di ambiente MQS_DISABLE_ALL_INTERCEPT solo per i client C. Per client Java , è necessario utilizzare invece la variabile di ambiente AMQ_DISABLE_CLIENT_AMS .

Per ulteriori informazioni, consultare Disabilitazione di Advanced Message Security sul client.

HOST IP_MQS

Poiché gli oggetti del file system IPC devono essere distinti dal sistema, una sottodirectory per ciascun sistema su cui viene eseguito il gestore code viene aggiunta al percorso della directory. Se il valore generato del nome host crea un problema, è possibile impostare il nome host utilizzando la variabile di ambiente MQS_IPC_HOST .

Per ulteriori informazioni, consultare Condivisione dei file IBM MQ su Multiplatforms.

MQS_KEYSTORE_CONF

La variabile di ambiente MQS_KEYSTORE_CONF specifica l'ubicazione del file di configurazione del keystore per IBM MQ Advanced Message Security (AMS), se il file non si trova nell'ubicazione predefinita di home_directory/.mqs/keystore.conf.

Per ulteriori informazioni, consultare Utilizzo di keystore e certificati con AMS.

Se hai dei problemi su Managed File Transfer, vedi Risoluzione dei problemi quando MFT non legge le proprietà del keystore per AMS.

FILE_CHIAVE_MQS

Quando si configura la variabile di ambiente MQS_MQI_KEYFILE , specifica l'ubicazione di un file di chiavi iniziale che contiene la chiave iniziale da utilizzare per le operazioni di protezione con password. Se il file di chiavi iniziale non è specificato, la chiave iniziale predefinita viene utilizzata dal IBM MQ sistema di protezione con password.

Per impostare MQS_MQI_KEYFILE, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:

export MQS_MQI_KEYFILE=key file location

Sui Windows sistemi:
```
SET MQS_MQI_KEYFILE=key file location
```

Su IBM i:

ADDENVVAR ENVVAR(MQS_MQI_KEYFILE) VALUE(key file location)

Per ulteriori informazioni, consultare Come fornire una chiave iniziale per un IBM MQ MQI client su AIX, Linux, and Windows e Come fornire una chiave iniziale per un IBM MQ MQI client su IBM i.

FILE CHIAVE SSLCRYP MQS

La variabile di ambiente MQS_SSLCRYP_KEYFILE rappresenta un modo alternativo per specificare il nome e il percorso completo del file contenente la chiave iniziale utilizzata per codificare la password nella stringa di configurazione hardware crittografica PKCS #11 , invece di specificarla con l'attributo SSLCryptoHardwareKeyFile nella stanza SSL di qm.ini. MQS_SSLCRYP_KEYFILE ha una priorità superiore rispetto al file qm.ini , quindi il suo valore ha la precedenza su qualsiasi altro valore. Per ulteriori informazioni, consultare ClientIBM MQ che utilizzano hardware crittografico.

MQS_TRACE_OPZIONI

Per la traccia selettiva dei componenti su AIX, utilizzare la variabile d'ambiente MQS_TRACE_OPTIONS per attivare singolarmente le funzioni di traccia dei parametri e dei dettagli.

Nota: impostare la variabile di ambiente MQS_TRACE_OPTIONS solo se richiesto dal supporto IBM .

Per ulteriori informazioni, vedi Traccia su AIX and Linux.

MQS_GETGROUPLIST_API

La variabile d'ambiente MQS_GETGROUPLIST_API migliora le prestazioni, utilizzando l'API getgrouplist , più veloce, invece dell'API getgrent , più lenta. Aiuta a evitare i timeout del gestore delle code se l'azienda ha migliaia di gruppi da cercare.

Per abilitare la variabile d'ambiente MQS_GETGROUPLIST_API , è necessario procedere come segue:

Chiudere il gestore code.
Emetti il seguente comando:
```
export MQS_GETGROUPLIST_API=1
```
Riavviare il gestore code.

Questa modifica può anche risolvere RC2035 errori legati all'accesso al gruppo di utenti. Per ulteriori informazioni sulla variabile MQS_GETGROUPLIST_API , vedere Risoluzione di alcuni problemi di appartenenza a un gruppo su Linux

SERVER MQT

La variabile di ambiente MQSERVER viene utilizzata per definire un canale minimo. MQSERVER specifica l'ubicazione del server IBM MQ e il metodo di comunicazione da utilizzare.

Nota: non è possibile utilizzare MQSERVER per definire un canale TLS o un canale con uscite canale. Per ulteriori informazioni su come definire un canale TLS, vedi Protezione dei canali con TLS.

I seguenti esempi mostrano come impostare MQSERVER:

Su AIX and Linux:

export  MQSERVER='SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)'

Su Windows:

SET  MQSERVER=SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)

Su IBM i:

ADDENVVAR ENVVAR(MQSERVER) VALUE('SYSTEM.DEF.SVRCONN/TCP/AMACHINE.ACOMPANY.COM(1414)')

Nota:

Il nome del canale non può contenere il carattere barra (/) poiché questo carattere viene utilizzato per separare il nome del canale, il tipo di trasporto e il nome della connessione. Quando si utilizza la variabile di ambiente MQSERVER per definire un canale client, viene utilizzata una lunghezza massima del messaggio (MAXMSGL) di 100 MB. Pertanto, la dimensione massima del messaggio in vigore per il canale è il valore specificato nel canale SVRCONN sul server.
Il tipo di trasporto può essere uno tra LU62 , TCP , NETBIOS, SPX, a seconda della piattaforma client IBM MQ .
Il nome della connessione deve essere un nome di rete completo. ad esempio AMACHINE.ACOMPANY.COM(1414).
Il nome connessione può essere un elenco separato da virgole di nomi connessione. I nomi di connessione nell'elenco vengono utilizzati in modo simile a più connessioni in una tabella di connessioni client. L'elenco dei nomi delle connessioni potrebbe essere utilizzato come alternativa ai gruppi di gestori code per specificare più collegamenti per il client da provare. Se si sta configurando un gestore code a più istanze, è possibile utilizzare un elenco di nomi di connessione per specificare diverse istanze del gestore code.

Se si utilizza la variabile di ambiente MQSERVER per definire il canale tra la macchina IBM MQ MQI client e una macchina server, questo è l'unico canale disponibile per l'applicazione e non viene fatto alcun riferimento alla CCDT (client channel definition table).

Per ulteriori informazioni, vedere Creazione di un canale di connessione client su IBM MQ Client MQI utilizzando MQSERVER.

MQSNOAUT

Avvertenza: questa funzionalità è sconsigliata.

Quando si imposta la variabile di ambiente MQSNOAUT su qualsiasi valore, disabilita OAM (object authority manager) e impedisce qualsiasi controllo di sicurezza. Potrebbe essere adatto per un ambiente di test. Ciò include sia l'autorizzazione che la funzionalità di autenticazione della connessione. TLS, i record di autenticazione di canale e le uscite di sicurezza non sono interessati.

La variabile di ambiente MQSNOAUT ha effetto solo quando viene creato un gestore code.

Avvertenza: per abilitare OAM, è necessario eliminare il gestore code, eliminare la variabile di ambiente e ricreare il gestore code senza specificare MQSNOAUT.

Per ulteriori informazioni, consultare Prevenzione dei controlli di accesso di sicurezza sui sistemi AIX, Linuxe Windows.

MQSPREFIX

In alternativa alla modifica del prefisso predefinito, è possibile utilizzare la variabile di ambiente MQSPREFIX per sovrascrivere il DefaultPrefix per il comando crtmqm .

Per ulteriori informazioni, consultare i nomi IBM MQ dei file e la sezione AllQueueManagers del file mqs.ini.

CCRYMQSSL

La variabile di ambiente MQSSLCRYP contiene una stringa di parametro che è possibile utilizzare per configurare l'hardware crittografico presente nel sistema.

I valori consentiti sono uguali a quelli del campo SSLCryptoHardware nella stanza SSL del file di configurazione client.

Per impostare MQSSLCRYP, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQSSLCRYP=string
```
Sui Windows sistemi:
```
SET MQSSLCRYP=string
```

Per ulteriori informazioni, consultare Configurazione per l'hardware crittografico su AIX, Linux, and Windows e IBM MQ clients che utilizzano l'hardware crittografico in Protezione delle password nei file di configurazione del componente IBM MQ.

FIPS MQSSL

[ MQ 9.4.4 Oct 2025] La variabile di MQSSLFIPS ambiente specifica se devono essere utilizzate solo librerie e FIPS algoritmi crittografici certificati nel caso in cui la crittografia venga eseguita in IBM MQ.

[Supporto a lungo termine] La variabile di MQSSLFIPS ambiente specifica se devono essere utilizzati solo FIPS algoritmi certificati nel caso in cui venga eseguita la crittografia in IBM MQ.

È possibile impostare questa variabile d'ambiente su YES o NO L'impostazione predefinita è NO. Questi valori sono gli stessi del parametro SSLFIPS del comando ALTER QMGR del comando.

Per impostare MQSSLFIPS, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQSSLFIPS=YES|NO
```
Sui Windows sistemi:
```
SET MQSSLFIPS=YES|NO
```

Su IBM i:

ADDENVVAR ENVVAR(MQSSLFIPS) VALUE(YES|NO)

L'uso di algoritmi certificati FIPS è influenzato dall'uso di hardware crittografico. Per ulteriori informazioni, vedere Specificare che solo FIPS certificato CipherSpecs è utilizzato in fase di esecuzione sul client MQI.

MQSSLKEYR

La variabile di ambiente MQSSLKEYR specifica l'ubicazione del repository chiavi che contiene il certificato digitale appartenente all'utente.

Specificare il percorso completo e il nome file del repository chiavi. Se il suffisso del file non viene specificato, si presuppone che sia .kdb.

Per impostare MQSSLKEYR, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQSSLKEYR=pathname
```
Sui Windows sistemi:
```
SET MQSSLKEYR=pathname
```

Su IBM i:

ADDENVVAR ENVVAR(MQSSLKEYR) VALUE(pathname)

Non esiste alcun valore predefinito per questa variabile di ambiente.

Per ulteriori informazioni, consultare il parametro SSLKEYR del comando ALTER QMGR .

MQSSLPROX

La variabile d'ambiente MQSSLPROXY specifica il nome dell'host e il numero di porta del server proxy HTTP che deve essere utilizzato da GSKit per i controlli OCSP.

Per impostare MQSSLPROXY, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQSSLPROXY="string"
```
Sui Windows sistemi:
```
SET MQSSLPROXY= string
```

La stringa specificata con MQSSLPROXY può essere il nome host o l'indirizzo di rete del server proxy HTTP che deve essere utilizzato da GSKit per i controlli OCSP. Questo indirizzo può essere seguito da un numero di porta facoltativo, racchiuso tra parentesi. Se non si specifica alcun numero, viene utilizza la porta HTTP predefinita (80).

Ad esempio, sui AIX and Linux sistemi, è possibile utilizzare uno dei seguenti comandi:

export MQSSLPROXY="proxy.example.com(80)"

```
export MQSSLPROXY="127.0.0.1"
```

Per ulteriori informazioni, consultare Utilizzo di OCSP (Online Certificate Status Protocol).

RESET MQSSL

La variabile di ambiente MQSSLRESET specifica il numero di byte non codificati inviati e ricevuti su un canale TLS prima che la chiave segreta TLS venga rinegoziata. Può essere impostato su un numero intero compreso tra 0 e 999 999 999. Il valore predefinito è 0, che indica che le chiavi segrete non vengono mai rinegoziate. Se si specifica un conteggio di reimpostazione della chiave segreta TLS compreso nell'intervallo tra 1 byte e 32 KB, i canali TLS utilizzano un conteggio di reimpostazione della chiave segreta di 32 KB. Questo conteggio di reimpostazioni segrete evita un numero eccessivo di reimpostazioni di chiavi che si verificherebbe per valori di reimpostazione di chiavi segrete TLS di piccole dimensioni.

Per impostare MQSSLRESET, utilizzare uno dei seguenti comandi:

Sui AIX and Linux sistemi:
```
export MQSSLRESET=integer
```
Sui Windows sistemi:
```
SET MQSSLRESET=integer
```

Su IBM i:

ADDENVVAR ENVVAR(MQSSLRESET) VALUE(integer)

Per ulteriori informazioni, vedi Reimpostazione delle chiavi segrete SSL e TLS.

MQSUITEB

Puoi configurare IBM MQ per operare in conformità con lo standard NSA Suite B su piattaforme AIX, Linux, and Windows .

La variabile di ambiente MQSUITEB specifica se deve essere utilizzata la crittografia conforme a Suite B. Se deve essere utilizzata la crittografia Suite B, è possibile specificare la potenza della crittografia impostando MQSUITEB su uno dei seguenti valori:

Nessuna
128_BIT, 192_BIT
128_BIT
192_BIT

È possibile specificare più valori utilizzando un elenco separato da virgole. L'utilizzo del valore NONE con qualsiasi altro valore non è valido.

Per ulteriori informazioni, vedi Configurazione di IBM MQ per Suite B.

MQTCPTIMEOUT

La variabile di ambiente MQTCPTIMEOUT specifica per quanto tempo IBM MQ attende una chiamata di connessione TCP.

MQTRACEPATH

Quando si eseguono lunghe tracce di un gestore di code IBM MQ o di un'applicazione IBM MQ client basata su C, si possono attenuare i potenziali problemi di spazio su disco usando la variabile d'ambiente MQTRACEPATH per puntare a una directory con più spazio su disco.

Su AIX and Linux:
```
set MQTRACEPATH=/other/mqtrace
```
Su Windows:
```
set MQTRACEPATH=D:\mqtrace
```

Per ulteriori informazioni, vedere Tracing su AIX and Linux e Tracing su Windows.

Se si stanno tracciando i client di IBM MQ classes for .NET Framework usando un file di configurazione dell'applicazione, si può usare MQTRACEPATH per puntare a una cartella in cui verranno creati i file di traccia. Per ulteriori informazioni, vedere Tracciare i client di IBM MQ classes for .NET Framework usando un file di configurazione dell'applicazione.

ODQ_MSG

Se si utilizza un gestore code di messaggi non recapitabili diverso da quello di runmqdlq, l'origine dell'esempio, amqsdlq, è disponibile per l'utilizzo come base. L'esempio è simile al gestore di lettere non recapitate fornito all'interno del prodotto, ma la traccia e la notifica degli errori sono differenti. Utilizzare la variabile di ambiente ODQ_MSG per impostare il nome del file contenente i messaggi di errore e di informazioni. Il file fornito è denominato amqsdlq.msg.

Per ulteriori informazioni, vedere Esempio di gestore code di messaggi non instradabili.

TRACCIA_ODQ

Se si utilizza un gestore code di messaggi non recapitabili diverso da quello di runmqdlq, l'origine dell'esempio, amqsdlq, è disponibile per l'utilizzo come base. L'esempio è simile al gestore di lettere non recapitate fornito all'interno del prodotto, ma la traccia e la notifica degli errori sono differenti. Per abilitare la traccia, impostare la variabile di ambiente ODQ_TRACE su YES o yes.

Per ulteriori informazioni, vedere Esempio di gestore code di messaggi non instradabili.

TOKENCERTVPOL

TOKENCERTVPOL è una variabile d'ambiente opzionale per la politica di convalida dei certificati JWT che può essere configurata per la IBM MQ classes for JMS libreria client. È possibile utilizzare TOKENCERTVPOL per applicare il livello di convalida richiesto per il recupero del token tramite una connessione HTTPS. È possibile utilizzarlo per applicare il livello di convalida richiesto per il recupero CCDT tramite una connessione HTTPS, specificando uno dei seguenti valori:

ANY: Verifica che il certificato del peer sia valido, firmato da un'autorità attendibile, e ignora la verifica del nome host. Se viene fornito un SSLSocketFactory personalizzato, questo sostituisce il meccanismo predefinito di Java Secure Socket Extension (JSSE).
Nessuna: Tutti i certificati server vengono accettati senza convalida. Verrà utilizzata un'implementazione interna dell'handler che fornisce un'istanza SSLSocketFactory che considera attendibili tutti i certificati. Se viene fornito un SSLSocketFactory personalizzato, esso sostituisce l'implementazione dell'handler.
HOSTNAMECN: Verifica che il certificato del peer sia valido, firmato da un'autorità attendibile e che il nome distinto del certificato (comprese le estensioni CN e SAN) corrisponda a quello del server HTTP contattato. Se viene fornito un SSLSocketFactory personalizzato, questo sostituisce il meccanismo predefinito di JSSE.

Per ulteriori informazioni, vedere Configurazione delle politiche di convalida dei certificati in IBM MQ.

WCF_TRACE_ON

Sono disponibili due diversi metodi di traccia per il canale personalizzato WCF. Questi due metodi di traccia vengono attivati indipendentemente o insieme. Ogni metodo produce il proprio file di traccia, quindi quando entrambi i metodi di traccia sono stati attivati, vengono generati due file di output di traccia. Esistono quattro combinazioni per abilitare e disabilitare i due diversi metodi di traccia. Oltre a queste combinazioni per abilitare la traccia WCF, la traccia XMS .NET può essere abilitata utilizzando la variabile di ambiente WCF_TRACE_ON .

Per ulteriori informazioni, vedi Traccia del canale personalizzato WCF per IBM MQ.

HOME WMQSOAP

La variabile di ambiente WMQSOAP_HOME viene utilizzata quando si completano ulteriori operazioni di configurazione dopo che l'ambiente di hosting del servizio .NET SOAP over JMS è stato installato e configurato correttamente in IBM MQ. È accessibile da un gestore code locale.

Per ulteriori informazioni, vedi Client WCF a un servizio .NET ospitato dall'esempio IBM MQ e Client WCF a un servizio Axis Java ospitato dall'esempio IBM MQ.

XMS_TRACE_ON, XMS_TRACE_FILE_NUMBER, XMS_TRACE_FILE_PATH, XMS_TRACE_FILE_SIZE, XMS_TRACE_FORMAT e XMS_TRACE_SPECIFICATION

Se si utilizza IBM MQ classes for XMS .NET Framework, è possibile configurare la traccia da un file di configurazione dell'applicazione e dalle variabili di ambiente XMS . Se si utilizza IBM MQ classes for XMS .NET (librerie.NET Standard e .NET 6 ), è necessario configurare la traccia dalle variabili di ambiente XMS . La traccia viene normalmente utilizzata sotto la guida del supporto IBM .

Per abilitare e configurare la traccia per un'applicazione XMS .NET , impostare le seguenti variabili di ambiente prima di eseguire l'applicazione:

TRACE_XMS ON: Se la variabile di ambiente XMS_TRACE_ON è impostata, tutta la traccia è abilitata per impostazione predefinita.
XMS_TRACE_FILE_NUMBER: La variabile d'ambiente XMS_TRACE_FILE_NUMBER specifica il numero di file di traccia che devono essere conservati. L'impostazione predefinita è 4 (un file attivo e 3 file di archivio). Il numero minimo consentito è 2.
PERCORSO_FILE_TRACCIA_X: La variabile di ambiente XMS_TRACE_FILE_PATH specifica il nome percorso completo della directory in cui vengono scritti i record FFDC e di traccia, se si desidera che tali record vengano scritti in un'ubicazione alternativa dalla directory di lavoro corrente.
Dimensione file di traccia XMS: La variabile d'ambiente XMS_TRACE_FILE_SIZE specifica la dimensione massima consentita del file di traccia. Quando un file raggiunge questa dimensione, viene archiviato e rinominato. Il valore massimo predefinito è di 20 MB. La dimensione del file è specificata in byte. Ad esempio, XMS_TRACE_FILE_SIZE=20000000.
FORMATO_TRACCIA_XMS: La variabile di ambiente XMS_TRACE_FORMAT specifica il formato di traccia richiesto, che può essere BASIC o ADVANCED.
SPECIFICA_TRACCIA_XMS: La variabile di ambiente XMS_TRACE_SPECIFICATION sostituisce le impostazioni di traccia definite nella sezione Traccia di un file di configurazione dell'applicazione. XMS_TRACE_SPECIFICATION si applica solo a IBM MQ classes for XMS .NET Framework .

Per ulteriori informazioni, vedi Traccia delle applicazioni XMS .NET e Traccia delle applicazioni XMS .NET utilizzando le XMS variabili di ambiente.