Proprietà di IBM MQ

Le proprietà di IBM® MQ si applicano a tutta l'installazione di IBM MQ

Le seguenti tabelle elencano le proprietà che è possibile impostare per IBM MQ:

Per ciascuna proprietà, è riportata una breve descrizione di quando è necessario configurare la proprietà. Le proprietà nelle finestre di dialogo delle proprietà di IBM MQ sono correlate alle stanze nei file di configurazione.

Pagina Generale

La seguente tabella elenca le proprietà che è possibile impostare nella pagina Generale della finestra di dialogo Proprietà per IBM MQ.

Proprietà Descrizione Chiave stanza
Prefisso predefinito Per modificare il percorso della directory in cui sono memorizzati i dati dei gestori code, immettere il percorso completo della nuova directory. DefaultPrefix
Nome gestore code predefinito Per specificare un nome predefinito per i nuovi gestori code, immettere il nome in questo campo. Nome

Pagina Esteso

La seguente tabella elenca le proprietà che è possibile impostare nella pagina Esteso della finestra di dialogo Proprietà per IBM MQ.

Proprietà Descrizione Chiave stanza
Prefisso temporaneo predefinito Per modificare il percorso della directory in cui sono memorizzati tutti i dati dei gestori code temporanei, immettere il percorso completo della nuova directory. DefaultEphemeralPrefix
Converti carattere di fine riga EBCDIC Le pagine di codice EBCDIC contengono un carattere di nuova riga (NL) che non è supportato dalle tabelle codici ASCII (sebbene alcune varianti ISO di ASCII contengano un carattere equivalente). Se i messaggi vengono inviati da un sistema che utilizza le codepage EBCDIC (ad esempio, un sistema z/OS® ) a un sistema che utilizza ASCII, è possibile controllare il modo in cui il carattere di nuova riga EBCDIC viene convertito in formato ASCII. Il valore predefinito è NL_TO_LF, che significa che il carattere EBCDIC NL (X'15') è convertito nel carattere ASCII LF (X'0A') per tutte le conversioni di tipo EBCDIC - ASCII. Per convertire il carattere EBCDIC NL in base alle tabelle di conversione sul sistema operativo in uso, selezionare TABLE. I risultati di una conversione TABLE possono variare da piattaforma a piattaforma e da linguaggio a linguaggio; anche sulla stessa piattaforma, i risultati possono variare se si utilizzano diversi ID del set di caratteri codificato (CCSID). Per convertire i CCSID ISO mediante il metodo TABLE e utilizzare il metodo NL_TO_LF per tutti gli altri CCSID, selezionare ISO. ConvEBCDICNewline
Modalità carico di lavoro cluster L'uscita del carico di lavoro del cluster, CLWL, consente di specificare quale coda del cluster debba essere aperta in risposta a una chiamata MQI (ad esempio, MQOPEN o MQPUT). Il valore predefinito è SAFE che significa che l'uscita CLWL viene eseguita in un processo separato sul gestore code in modo tale che, se si verifica un problema, l'integrità del gestore code viene preservata. Tuttavia, l'esecuzione dell'uscita CLWL come processo separato può avere un impatto negativo sulle prestazioni. Per migliorare le prestazioni eseguendo l'uscita CLWL nello stesso processo del gestore code, selezionare FAST. Utilizzare la modalità FAST soltanto se si è certi che non esiste alcun problema con l'uscita CLWL in quanto, se si verifica un problema, il gestore code riporterà un errore e l'integrità del gestore code sarà a rischio. Questo valore può essere sovrascritto per i singoli gestori code utilizzando la proprietà modo carico di lavoro cluster. Per ulteriori informazioni, fare riferimento alla sezione Proprietà del gestore code. CLWLMode

Pagina Uscite

La seguente tabella elenca le proprietà che è possibile impostare nella pagina Uscite della finestra di dialogo Proprietà per IBM MQ. Per configurare le uscite comuni a tutti i gestori code sul computer, modificare le proprietà nella pagina Uscite.

Proprietà Descrizione Chiave stanza
Percorso predefinito uscite Per modificare il percorso delle uscite del canale per i client e la conversione dati per i server, immettere il percorso completo nella nuova directory. ExitsDefaultPath
Uscite API comuni Per configurare una nuova uscita API comune per IBM MQ, fare clic su Aggiungi e quindi, nella finestra di dialogo Proprietà, immettere i dettagli dell'uscita. Per modificare un'uscita API comune già visualizzata nella tabella, fare clic su Modifica; per rimuovere un'uscita API dalla tabella, fare clic su Rimuovi. ApiExitCommon
Uscite API modello Per configurare una nuova uscita API modello per IBM MQ, fare clic su Aggiungi e quindi, nella finestra di dialogo Proprietà, immettere i dettagli dell'uscita. Per modificare un'uscita API modello già visualizzata nella tabella, fare clic su Modifica; per rimuovere un'uscita API dalla tabella, fare clic su Rimuovi. ApiExitTemplate
Nome Specifica il nome descrittivo dell'uscita API inviato all'uscita API nel campo ExitInfoName della struttura MQAXP. Questo nome deve essere univoco, ha una lunghezza massima di 48 caratteri e deve contenere solo i caratteri validi per il nome degli oggetti IBM MQ, quali i nomi coda. Nome
Tipo Specifica il tipo di uscita: common o template. (Non una chiave della stanza separata)
Sequenza Questa proprietà è un valore numerico senza segno che definisce la sequenza in cui viene chiamata questa uscita API rispetto ad altre uscite API. Un'uscita API con un numero di sequenza basso viene richiamata prima di un'uscita con un numero di sequenza maggiore. L'ordine in cui le diverse uscite API con lo stesso numero di sequenza vengono richiamate non è definito. Questo è il valore perfetto per cui esistono dei divari nei numero di sequenza delle uscite API definite per un gestore code. Sequenza
Modulo Specifica il modulo che contiene il codice per l'uscita API. Se questo campo contiene il percorso completo del modulo, questo verrà visualizzato così come è. Se questo campo contiene solo il nome del modulo, il modulo si trova utilizzando lo stesso metodo delle uscite di canale, cioè utilizzando il valore nel campo Exit default path nella pagina Uscite della finestra di dialogo delle proprietà del gestore code. Modulo
Funzione Specifica il punto di ingresso della funzione nel modulo che contiene il codice per l'uscita API. Questo punto di ingresso è la funzione MQ_INIT_EXIT. La lunghezza di questo campo è limitata a MQ_EXIT_NAME_LENGTH. Funzione
Dati Se questa proprietà viene specificata, gli spazi vuoti iniziali e finali vengono rimossi, la stringa rimanente viene troncata a 32 caratteri e il risultato viene inviato all'uscita nel campo ExitData della struttura MQAXP. Se invece la proprietà non viene specificata, il valore predefinito di 32 spazi vuoti viene inviato all'uscita nel campo ExitData della struttura MQAXP. Dati

Impostazioni log predefinite

La seguente tabella elenca le proprietà che è possibile impostare nella pagina Impostazioni log predefinite della finestra di dialogo Proprietà per IBM MQ. Per modificare le impostazioni predefinite dei log, modificare le proprietà nella pagina Impostazioni log predefinite. Per impostazione predefinita, tali impostazioni vengono applicate a tutti i nuovi gestori code.

Proprietà Descrizione Chiave stanza
Tipo di log Per abilitare il ripristino automatico del gestore code quando viene riavviato, selezionare Circolare. Se il gestore code utilizza questo tipo di registrazione, quando il file di log è pieno, il file viene sovrascritto a cominciare dall'inizio del file. Per abilitare il ripristino automatico del gestore code quando viene riavviato e per abilitare il ripristino di inoltro o dei supporti, selezionare Lineare. Se il gestore code utilizza questo tipo di registrazione, quando il file di log è pieno, ne verrà creato uno nuovo. LogType
Percorso log Per modificare il percorso predefinito dei log, immettere qui il percorso completo. Se non si specifica il percorso qui, l'impostazione predefinita è una sottodirectory chiamata Log in DefaultPrefix, dove DefaultPrefix è la directory specificata nella proprietà Default prefix nella pagina Generale della finestra di dialogo Proprietà per IBM MQ. LogPath
Pagine file di log Immettere il numero, compreso tra 32 e 4095, di pagine da 4KB nel file di log. Ad esempio, se si immette256, la dimensione file è 1MB. LogFilePages
File primari log

Su AIX® and Linux®, immettere il numero, da 2 a 510, di file di log primari. Il valore predefinito è 3. Il numero totale dei file di log primari e secondari non deve essere superiore a 511 e non deve essere inferiore a 3.

Su Windows, immettere il numero, compreso tra 2 e 254, di file di log primari. Il valore predefinito è 3. Il numero totale dei file di log primari e secondari non deve essere superiore a 255 e non deve essere inferiore a 3.

LogPrimaryFiles
File secondari log

Su AIX and Linux, immettere il numero, da 1 a 509, di file di log secondari. Il valore predefinito è 3. Il numero totale dei file di log primari e secondari non deve essere superiore a 511 e non deve essere inferiore a 3.

Su Windows, immettere il numero, compreso tra 1 e 253, di file di log secondari. Il valore predefinito è 3. Il numero totale dei file di log primari e secondari non deve essere superiore a 255 e non deve essere inferiore a 3.

LogSecondaryFiles
Pagine buffer log Immettere il numero, compreso tra 0 e 512, di pagine di buffer da 4 KB per la scrittura. Se si specifica 0, il gestore code selezionerà il numero.

Se si specifica un numero compreso tra e 17, verrà utilizzato il minimo 18. Se si specifica un valore compreso tra 18 e 512, viene utilizzato quel numero di pagine. Se si modifica il valore di questa proprietà, riavviare il gestore code affinché la modifica sia rilevata.

LogBufferPages
Integrità di scrittura log Il metodo utilizzato dal programma di registrazione per scrivere in maniera corretta i record di log.

Il valore predefinito è TripleWrite. Nota: è possibile selezionare DoubleWrite ma, in tal caso, il sistema l'interpreta come TripleWrite.

Si deve utilizzare SingleWrite solo se il file system o l'unità che ospita il file di ripristino IBM MQ garantisce l'atomicità delle scritture di 4KB.

Ossia, quando una scrittura di una pagina di 4KB non riesce per un qualsiasi motivo, i soli due stati possibili sono la pre-immagine o la post-immagine. Non deve essere possibile alcuno stato intermedio.

LogWriteIntegrity
Gestione log Il metodo utilizzato per gestire i log. LogManagement si applica solo quando LogType è LINEAR.

Se si modifica il valore LogManagement, la modifica non ha effetto fino al riavvio del gestore code.

Esistono tre opzioni.

Manuale, in cui si gestiscono le estensioni log manualmente. Specificando questa opzione il gestore code non riutilizza o elimina le estensioni log, anche quando non sono più necessarie per il ripristino.

Automatico, in cui le estensioni log vengono gestite automaticamente dal gestore code. Specificando questa opzione il gestore code può riutilizzare o eliminare le estensioni log quando non sono più necessarie per il ripristino. Nessuna agevolazione viene effettuata per l'archiviazione.

Archivio, in cui le estensioni log sono gestite dal gestore code, ma si deve notificare al gestore code quando l'archiviazione di ogni estensione log è completa.

Specificando questa opzione il gestore code è libero di riutilizzare o eliminare un'estensione log esistente, come viene notificato che un'estensione log non è più necessaria per il ripristino essa viene archiviata.

Il valore predefinito è Manuale.

LogManagement

Pagina ACPI

La seguente tabella elenca le proprietà che è possibile impostare nella pagina ACPI della finestra di dialogo Proprietà per IBM MQ. ACPI (Advanced Configuration and Power ® Interface) è una funzione del sistema operativo che consente al computer di rilevare determinati stati di attività e di conseguenza di sospendersi, ovvero di passare a una modalità a bassa potenza senza programmi in esecuzione, e in modo tale da consentire un rapido "risveglio".

Quando ACPI inserisce il computer in fase di ibernazione, invia prima una richiesta di sospensione a tutte le applicazioni. Per controllare il modo in cui IBM MQ risponde a questa richiesta, impostare la proprietà Finestra Esegui nella pagina ACPI.

Proprietà Descrizione Chiave stanza
Finestra Esegui Il valore predefinito è , che significa che IBM MQ visualizza un messaggio che chiede all'utente se sospendere i gestori code in esecuzione. Per sospendere IBM MQ senza visualizzare questo messaggio, fare clic su No. DoDialog
Nega sospensione Se la proprietà Do dialog non è impostata o se è impostata ma la finestra di dialogo non può essere visualizzata (ad esempio, se un computer portatile ha il suo coperchio chiuso) quindi Deny suspend controlla la risposta. Il valore predefinito è No, che significa che IBM MQ viene sospeso, anche se non è possibile visualizzare la finestra di dialogo. Per impedire la sospensione di IBM MQ quando non è possibile visualizzare la finestra di dialogo, fare clic su . Questa proprietà può essere sovrascritta dalla proprietà Check channels running. DenySuspend
Verifica canali in esecuzione Il valore predefinito è No, il che significa che IBM MQ non controlla se ci sono canali in esecuzione e risponde come diretto dalle proprietà Do dialog e Deny suspend. Per verificare se sono presenti canali in esecuzione, selezionare . Se non ci sono canali in esecuzione, IBM MQ ignora le proprietà Do dialog e Deny suspend. Se ci sono canali in esecuzione, IBM MQ risponde come diretto dalle proprietà Do dialog e Deny suspend. CheckChannelsRunning
[ Windows]

Pagina Controllo segnalazioni

Il Controllo segnalazioni è disponibile solo su Windows.

La seguente tabella elenca le proprietà che è possibile impostare nella pagina Controllo segnalazioni della finestra di dialogo Proprietà per IBM MQ. Il Controllo segnalazioni è particolarmente utile per la determinazione dei problemi. Le segnalazioni vengono emesse dai servizi quando si verifica un problema; ad esempio se un servizio di un iniziatore di canali non può essere avviato in quanto è stata eliminata una coda necessaria. Per configurare il controllo segnalazioni, modificare le proprietà nella pagina Controllo segnalazioni.

Proprietà Descrizione Chiave stanza
Controllo segnalazioni notifica all'utente Il valore predefinito è No, che significa che IBM MQ non invia segnalazioni all'utente quando c'è un problema. Per configurare IBM MQ per inviare segnalazioni quando c'è un problema, fare clic su . Abilita
Utente del controllo segnalazioni Immettere il nome computer o il nome utente a cui IBM MQ deve inviare le segnalazioni. Destinatario
Icona del controllo segnalazioni aggiunta alla barra delle attività Il valore predefinito è No, che significa che l'icona del Controllo segnalazioni non viene visualizzata sulla barra delle attività di Windows. Per visualizzare l'icona del Controllo segnalazioni nella barra delle attività di Windows, fare clic su . TaskBar

Pagina Informazioni sulla configurazione

La seguente tabella elenca le proprietà visualizzate nella pagina Informazioni sulla configurazione della finestra di dialogo Proprietà per IBM MQ. Le proprietà nella pagina Informazioni sulla configurazione sono di sola lettura.

Proprietà Descrizione
Tipo di installazione Sola lettura. Questa proprietà indica se è stata installata la versione Server o Client di IBM MQ su questo computer.
mqjbnd05 caricato. Sola lettura. Questa è la libreria richiesta per connettersi ai gestori code locali.
Versione MQ Sola lettura. Questa è la versione di IBM MQ installata su questo computer.
Livello build Sola lettura. Questo è il numero di build del prodotto IBM MQ installato su questo computer.
Tipo build Sola lettura. Questo è il tipo di build del prodotto IBM MQ installato su questo computer.