Proprietà degli argomenti del cluster

È possibile impostare le proprietà per gli argomenti del cluster. Tuttavia, alcune proprietà possono essere modificate solo durante la creazione di un nuovo argomento del cluster. Non è possibile modificare queste proprietà dopo che l'argomento del cluster è stato creato.

Per configurare un cluster standard di gestori code per la messaggistica di pubblicazione/sottoscrizione, definire uno o più oggetti argomento amministrati su un gestore code nel cluster. Per rendere l'argomento un argomento del cluster, si configura la proprietà Nome cluster. Quando si esegue questa operazione, qualsiasi argomento utilizzato da un publisher o sottoscrittore, da quel punto in poi nella struttura ad albero degli argomenti, viene condiviso tra tutti i gestori code nel cluster. I messaggi pubblicati in un ramo del cluster della struttura ad albero degli argomenti vengono instradati automaticamente alle sottoscrizioni presenti su altri gestori code nel cluster.

Le seguenti tabelle elencano tutte le proprietà per gli argomenti cluster IBM® MQ . Alcune delle proprietà elencate in queste tabelle possono essere alterate solo durante la creazione di un nuovo argomento e non possono essere modificate una volta creato l'argomento cluster IBM MQ .

Per ogni proprietà, è riportata una breve descrizione di quando potrebbe essere necessario configurarla. Le tabelle forniscono anche il parametro MQSC equivalente da utilizzare (ad esempio) con il comando DISPLAY TCLUSTER. Per ulteriori informazioni sui comandi MQSC, consultare Amministrazione utilizzando i comandi MQSC in IBM Documentazione.

Generale

La seguente tabella elenca le proprietà sulla pagina Generale della finestra di dialogo Proprietà argomento cluster .
Proprietà Significato Parametro MQSC
Nome argomento Questo valore non può essere modificato a seguito della creazione dell'argomento. Questo parametro è richiesto e non può contenere una stringa vuota.

L'identificativo univoco della definizione dell'argomento di gestione che verrà creato. Il numero massimo di caratteri consentiti è 48.

Il Nome non deve essere lo stesso di altre definizioni argomento definite nel gestore code selezionato.

TOPNAME
Tipo di argomento Questo valore è di sola lettura. Questo valore viene visualizzato se l'argomento è locale; Local o in un cluster; Cluster. N/A
Stringa argomento Questo valore non può essere modificato a seguito della creazione dell'argomento. Questo parametro è richiesto e non può contenere una stringa vuota.

Il carattere / all'interno di questa stringa ha un significato speciale. Esso delimita, infatti, gli elementi nella struttura ad albero dell'argomento. Una stringa di un argomento può iniziare con il carattere / ma ciò non è necessario. Una stringa che inizia con il carattere / non è uguale alla stringa che inizia senza /.

La Stringa argomento non deve essere la stessa di altre stringhe argomento già rappresentate da un'altra definizione di un oggetto argomento. La lunghezza massima di una stringa argomento è di 10 240 caratteri.

TOPICSTR
Descrizione Questo valore è una stringa immessa dall'amministratore. Esso contiene le informazioni descrittive sull'argomento. Deve contenere esclusivamente caratteri visualizzabili. Il limite massimo di caratteri è 64.

Se vengono utilizzati dei caratteri non contenuti nel CCSID (coded character set identifier) per il gestore code selezionato, questi potrebbero essere trasferiti erroneamente, qualora le informazioni vengano inviate a un altro gestore code.

DESC
Pubblica Questa proprietà controlla se i messaggi possano essere pubblicati nell'argomento, o meno. Il valore predefinito è Come principale. Le altre 2 opzioni disponibili sono:

Consentito che significa che i messaggi possono essere pubblicati nell'argomento da un'applicazione autorizzata.

Non consentito che significa che i messaggi non possono essere pubblicati nell'argomento da un'applicazione autorizzata.

PUB
Sottoscrivi Questa proprietà controlla se i messaggi possano effettuare una sottoscrizione all'argomento, o meno. Il valore predefinito è Come principale. Le altre 2 opzioni disponibili sono:

Consentito che significa che è possibile eseguire sottoscrizioni all'argomento da parte di un'applicazione autorizzata.

Non consentito che significa che le applicazioni non possono effettuare sottoscrizioni all'argomento.

SUB
Sottoscrizioni durevoli Questa proprietà controlla se l'argomento consente l'esecuzione di sottoscrizioni durevoli. Il valore predefinito è Come principale. Le altre 2 opzioni disponibili sono:

Consentito che significa che è possibile eseguire sottoscrizioni durevoli all'argomento da parte di un'applicazione.

Non consentito che significa che non è possibile eseguire sottoscrizioni durevoli all'argomento da parte di un'applicazione.

DURSUB
Priorità predefinita La proprietà predefinita dei messaggi pubblicati nell'argomento. Il valore predefinito è Come principale.

La proprietà predefinita può essere impostata su un valore compreso fra 0 (priorità minima) e 9 (priorità massima)

DEFPRTY
Persistenza predefinita La persistenza predefinita di un nuovo argomento è Come principale. Selezionare Persistente per specificare che i messaggi creati dalle applicazioni che usano MQPER_PERSISTENCE_AS_Q_DEF diventano persistenti. Selezionare Non persistente per specificare che i messaggi creati dalle applicazioni che usano MQPER_PERSISTENCE_AS_Q_DEF diventano non persistenti. DEFPSIST
Tipo di risposta di inserimento predefinito Il tipo di risposta predefinito per gli inserimenti di messaggi. Il valore predefinito è Come principale. Le altre 2 opzioni disponibili sono:

Sincrono significa che la risposta viene inserita in modo sincrono.

Asincrono significa che la risposta viene inserita in modo asincrono.

DEFPRESP
Consegna di messaggi non persistenti Metodo di consegna dei messaggi non persistenti pubblicati in questo argomento. Le quattro opzioni sono:

Come principale Il meccanismo di consegna utilizzato si basa sull'impostazione del primo nodo di gestione principale trovato nella struttura ad albero dell'argomento relativa a questo argomento. Questo è il default fornito con IBM MQ, ma la vostra installazione potrebbe averla modificata.

A tutti i sottoscrittori disponibili I messaggi non persistenti vengono consegnati a tutti i sottoscrittori in grado di accettare il messaggio. La mancata consegna del messaggio a uno qualsiasi dei sottoscrittori non impedisce agli altri di ricevere il messaggio in questione.

A tutti i sottoscrittori durevoli I messaggi non persistenti devono essere consegnati a tutti i sottoscrittori durevoli. La mancata consegna di un messaggio non persistente a un qualsiasi sottoscrittore non persistente non restituisce alcun errore alla chiamata MQPUT. Se si verifica un errore di consegna a un sottoscrittore duraturo, nessun altro sottoscrittore riceverà il messaggio e la chiamata MQPUT non riuscirà.

A tutti i sottoscrittori I messaggi non persistenti devono essere consegnati a tutti i sottoscrittori, senza tenere conto della durabilità. Se si verifica un errore di consegna a un sottoscrittore, nessun altro sottoscrittore riceverà il messaggio e la chiamata MQPUT non riuscirà.

NPMSGDLV
Consegna di messaggi persistenti Metodo di consegna dei messaggi persistenti pubblicati in questo argomento. Le quattro opzioni sono:

Come principale Il meccanismo di consegna utilizzato si basa sull'impostazione del primo nodo di gestione principale trovato nella struttura ad albero dell'argomento relativa a questo argomento. Questo è il default fornito con IBM MQ, ma la vostra installazione potrebbe averla modificata.

A tutti i sottoscrittori disponibili I messaggi persistenti vengono consegnati a tutti i sottoscrittori in grado di accettare il messaggio. La mancata consegna del messaggio a uno qualsiasi dei sottoscrittori non impedisce agli altri di ricevere il messaggio in questione.

A tutti i sottoscrittori durevoli I messaggi persistenti devono essere consegnati a tutti i sottoscrittori durevoli. La mancata consegna di un messaggio persistente a un qualsiasi sottoscrittore non persistente non restituisce alcun errore alla chiamata MQPUT. Se si verifica un errore di consegna a un sottoscrittore duraturo, nessun altro sottoscrittore riceverà il messaggio e la chiamata MQPUT non riuscirà.

A tutti i sottoscrittori I messaggi persistenti devono essere consegnati a tutti i sottoscrittori, senza tenere conto della durabilità, affinché la chiamata MQPUT comunichi l'avvenuta riuscita. Se si verifica un errore di consegna a un sottoscrittore, nessun altro sottoscrittore riceverà il messaggio e la chiamata MQPUT non riuscirà.

PMSGDLV
Operazione caratteri jolly Questo valore controlla il comportamento delle sottoscrizioni di caratteri jolly rispetto all'argomento. I due valori sono:

Blocco. Le sottoscrizioni effettuate a un argomento carattere jolly meno specifico della stringa argomento per questo oggetto argomento non riceveranno le pubblicazioni eseguite per questo argomento o per stringhe argomento più specifiche di tale argomento.

Passthrough. Le sottoscrizioni effettuate a un argomento carattere jolly meno specifico della stringa argomento per questo oggetto argomento riceveranno le pubblicazioni eseguite per questo argomento o per stringhe argomento più specifiche di tale argomento. Questo è il valore predefinito.
WILDCARD

Pubblicazione/sottoscrizione distribuita

Nella seguente tabella sono elencate le proprietà visualizzate nella pagina Pubblicazione/sottoscrizione distribuita della finestra Proprietà degli argomenti del cluster.
Proprietà Significato Parametro MQSC
Comportamento della sottoscrizione proxy Le sottoscrizioni proxy sono associate al nome del gestore code che le ha create. Le pubblicazioni vengono inoltrate esclusivamente ai gestori code connessi direttamente, nel caso in cui esista una sottoscrizione proxy che includa l'argomento della pubblicazione. Le due opzioni per questo valore sono:

Forza. Questo forza l'invio di una sottoscrizione proxy con caratteri jolly per la stringa argomento associata a questo oggetto argomento da ogni gestore code nel cluster a ogni altro gestore code nella topologia pub/sub, indipendentemente dal fatto che siano state eseguite delle sottoscrizioni locali o meno. Dopo che la sottoscrizione proxy è stata propagata in tutta la topologia, eventuali nuove sottoscrizioni ricevono immediatamente le pubblicazioni da altri gestori code connessi senza subire latenza, sebbene tutte le pubblicazioni siano propagate a tutti gli altri gestori code nel cluster indipendentemente dal fatto che una sottoscrizione le abbia richieste o meno.

L'impostazione di questo valore in un determinato livello della struttura ad albero degli argomenti impedisce anche che le sottoscrizioni proxy vengano generate per singole stringhe argomento nei livelli successivi della struttura ad albero, riducendo il sovraccarico delle sottoscrizioni proxy.

Primo utilizzo. Poiché le varie topologie dei gestori code pub/sot hanno una natura interconnessa, potrebbe verificarsi un breve ritardo nella distribuzione della sottoscrizione proxy, a seconda della complessità della topologia. Ciò significa che, quando viene eseguita una sottoscrizione, le pubblicazioni remote non saranno necessariamente ricevute immediatamente.

PROXYSUB
Ambito della pubblicazione
L'ambito delle pubblicazioni può essere controllato a livello amministrativo, utilizzando l'attributo dell'argomento PUBSCOPE. L'attributo può essere impostato su uno dei tre valori seguenti:
  • Come principale. Questo è il valore predefinito. L'ambito della pubblicazione viene impostato sullo stesso valore del gestore code principale.
  • Gestore code. La pubblicazione viene consegnata solo ai sottoscrittori locali.
  • Tutti. La pubblicazione viene consegnata ai sottoscrittori locali ed a quelli remoti attraverso gestori code connessi direttamente.
PUBSCOPE
Ambito della sottoscrizione
L'ambito delle sottoscrizioni può essere controllato a livello amministrativo, utilizzando l'attributo dell'argomento SUBSCOPE. L'attributo può essere impostato su uno dei tre valori seguenti:
  • Come principale. Questo è il valore predefinito. L'ambito della sottoscrizione viene impostato sullo stesso valore del gestore code principale.
  • Gestore code. La sottoscrizione riceve soltanto pubblicazioni locali e le sottoscrizioni proxy non vengono propagate ai gestori code remoti.
  • Tutti. Una sottoscrizione proxy viene propagata ai gestori code remoti e il sottoscrittore riceve pubblicazioni locali e remote.
SUBSCOPE

Cluster

La seguente tabella elenca le proprietà sulla pagina Cluster della finestra di dialogo Proprietà argomento cluster .
Proprietà Significato Parametro MQSC
Nome cluster Per rendere un argomento un argomento del cluster, è necessario configurare questa proprietà. Quando si esegue questa operazione, qualsiasi argomento utilizzato da un publisher o sottoscrittore in quel punto o nella struttura ad albero degli argomenti viene condiviso tra tutti i gestori code nel cluster e i messaggi pubblicati in un ramo del cluster della struttura ad albero degli argomenti vengono instradati automaticamente alle sottoscrizioni presenti su altri gestori code nel cluster. Cluster
Stato oggetto cluster
Lo stato corrente di questo oggetto argomento nel cluster. I valori possono essere i seguenti:
ATTIVO
L'argomento del cluster è configurato correttamente ed è conforme a questo gestore code.
IN SOSPESO
Questo stato, che viene visualizzato solo da un gestore code host, viene riportato quando l'argomento è stato creato ma il repository completo non lo ha ancora propagato al cluster. Ciò potrebbe dipendere dal fatto che il gestore code host non è connesso a un repository completo o perché il repository completo ha ritenuto l'argomento non valido.
Non valido
Questa definizione dell'argomento cluster è in conflitto con una definizione precedente nel cluster e pertanto non è attualmente attiva.
ERROR
Si è verificato un errore rispetto a questo oggetto argomento.
Questo parametro è in genere utilizzato per favorire la diagnosi quando più definizioni dello stesso argomento del cluster sono definite su gestori code differenti e le definizioni non sono identiche.
CLSTATE
Gestore code del cluster Questo è il nome del gestore code nel cluster che possiede l'argomento cluster. N/A
Instradamento cluster
Il comportamento dell'instradamento da utilizzare per gli argomenti nel cluster definito dal parametro CLUSTER. Esistono due valori possibili:
Diretto
Quando si configura un argomento di cluster con instradamento diretto su un gestore code, tutti i gestori code presenti nel cluster sono a conoscenza di tutti gli altri gestori code del cluster. Quando si effettuano operazioni di pubblicazione e sottoscrizione, ogni gestore code si connette direttamente a tutti gli altri.
TOPICHOST
Quando si utilizza l'instradamento all'host argomento, tutti i gestori code presenti nel cluster sono a conoscenza dei gestori code del cluster che ospitano le definizioni dell'argomento instradato. Quando si effettuano operazioni di pubblicazione e sottoscrizione, i gestori code del cluster si connettono soltanto a questi gestori code dell'host argomento e non direttamente l'uno all'altro. I gestori code dell'host argomento sono responsabili dell'instradamento delle pubblicazioni dai gestori code su cui vengono pubblicate le pubblicazioni ai gestori code con le sottoscrizioni corrispondenti.
CLROUTE
QMID Il nome univoco del gestore code del cluster generato internamente. Per evitare qualsiasi ambiguità, è preferibile utilizzare QMID (Queue manager identifier) piuttosto che QMNAME. QMID

Statistiche

La seguente tabella elenca le proprietà sulla pagina Statistiche della finestra di dialogo Proprietà argomento cluster .
Proprietà Significato Parametro MQSC
Data della modifica Questo valore non può essere modificato e viene fornito esclusivamente a scopo informativo.

Questa è la data dell'ultima modifica delle proprietà dell'argomento.

MQCA_ALTERATION_DATE
Ora della modifica Questo valore non può essere modificato e viene fornito esclusivamente a scopo informativo.

Questa è l'ora dell'ultima modifica delle proprietà dell'argomento.

MQCA_ALTERATION_TIME