Proprietà degli argomenti

Un argomento IBM® MQ è un oggetto IBM MQ che identifica di cosa si tratta una pubblicazione. È possibile impostare le proprietà per gli argomenti. Alcune proprietà dell'argomento sono specifiche per gli argomenti z/OS® . Inoltre, ci sono alcune proprietà che è possibile modificare solo durante la creazione di un argomento. Non è possibile modificare queste proprietà dopo che è stato creato l'argomento IBM MQ .

Le seguenti tabelle elencano tutte le proprietà per IBM MQ Argomenti.

Per ciascuna proprietà, è riportata una breve descrizione di quando è necessario configurare la proprietà. Nelle tabelle sono riportati anche i parametri MQSC equivalenti per i comandi DEFINE, ALTER e DISPLAY TOPIC. 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 IBM MQ Proprietà argomento .
Proprietà Significato Parametro MQSC
Nome argomento Questo valore non può essere modificato dopo la 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 argomento 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 definisce se l'argomento è locale; Local o in un cluster; Cluster. N/A
Stringa argomento Questo valore non può essere modificato dopo la 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
Coda durevole dei modelli

Questo valore è una stringa immessa dall'amministratore. Contiene il nome della coda dei modelli utilizzata per le sottoscrizioni durevoli che richiedono che il gestore code gestisca la destinazione delle proprie pubblicazioni.

Il numero massimo di caratteri consentiti per il nome è 48.

Se questo campo è vuoto, verrà considerato Come principale

Se si sta specificando una coda di modelli per un argomento del cluster, è necessario accertarsi che la coda sia definita su ogni gestore code nel cluster in cui è possibile effettuare una sottoscrizione duratura che utilizza questo argomento.

La coda dinamica creata da questo modello ha il prefisso SYSTEM.MANAGED.DURABLE

MDURMDL
Coda non durevole dei modelli Questo valore è una stringa immessa dall'amministratore. Contiene il nome della coda dei modelli utilizzata per le sottoscrizioni non durevoli che richiedono che il gestore code gestisca la destinazione delle proprie pubblicazioni.

Il numero massimo di caratteri consentiti per il nome è 48.

Se questo campo è vuoto, verrà considerato Come principale

Se si sta specificando una coda di modelli per un argomento del cluster, è necessario accertarsi che la coda sia definita su ogni gestore code nel cluster in cui è possibile effettuare una sottoscrizione non duratura che utilizza questo argomento.

La coda dinamica creata da questo modello ha il prefisso SYSTEM.MANAGED.NDURABLE

MNDURMDL
Disposizione gruppo di condivisione code La disposizione del gruppo di condivisione code dell'argomento. È possibile impostare la disposizione del gruppo di condivisione code su uno di questi tre valori:
  • Gestore code significa che la definizione dell'oggetto è disponibile solo al gestore code su cui si trova.
  • Gruppo significa che la definizione dell'oggetto è memorizzata sul repository condiviso e ogni gestore code nel gruppo di condivisione code ha una copia della definizione.
  • Copia significa che la definizione dell'oggetto è la copia del gestore code di una definizione nel repository condiviso.
Il campo viene visualizzato come di sola lettura quando si stanno visualizzando le proprietà di un argomento.
QSGDISP
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 relative a questo argomento o a 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 relative a questo argomento o a stringhe argomento più specifiche di tale argomento. Questo è il valore predefinito.

WILDCARD
Utilizza coda di messaggi non recapitabili Specifica se viene utilizzata la coda di messaggi non recapitabili quando i canali non sono in grado di consegnare i messaggi di pubblicazione. Esistono tre valori possibili:
  • No significa che i messaggi di pubblicazione che non possono essere consegnati alla propria coda di abbonamento corretto sono trattati come un mancato inserimento del messaggio e la MQPUT dell'applicazione su un argomento non riesce in conformità alle impostazioni di Consegna dei messaggi non persistenti e Persistente messaggio di consegna.
  • significa che se la proprietà del gestore code Dead - letter queue fornisce il nome di una Coda Dead Letter, allora viene utilizzata. Altrimenti il funzionamento avviene come per No.
  • Come elemento principale significa che la decisione di utilizzare una coda di messaggi non recapitabili si basa sull'impostazione dell'oggetto argomento di gestione più vicino nella struttura ad albero dell'argomento. Questo è il default fornito con IBM MQ ma la vostra installazione potrebbe averla modificata.
USEDLQ
Personalizzato Il parametro Custom è incluso solo per l'utilizzo IBM , riservato alla configurazione di nuove funzioni prima che siano state introdotte proprietà separate. I valori possibili sono un elenco di zero o più coppie di proprietà-valore, nella sintassi di tipo MQSC, separate da almeno uno spazio.
I nomi e i valori delle proprietà sono sensibili al maiuscolo/minuscolo e devono essere specificati in maiuscolo. I valori possono contenere spazi, parentesi e apici (che devono essere rese leggibili con un altro apice). Altri caratteri, tra cui le parentesi nidificate (), possono essere inclusi racchiudendole tra due apici su entrambi i lati. Esempi di sintassi valida sono:
  • CUSTOM('')
  • CUSTOM('A(B)')
  • CUSTOM('C(D) E(F)')
  • CUSTOM('G(5000) H(''9.20.4.6(1415)'')')

Il gestore code analizza il valore, ma se la stringa non può essere analizzata in base a queste regole o se contiene proprietà o valori che non vengono riconosciuti, il gestore code ignora gli errori.

CUSTOM

Pubblicazione/sottoscrizione distribuita

La seguente tabella elenca le proprietà sulla pagina Distributed Pub / Sub della finestra di dialogo IBM MQ Proprietà topiche .
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. Per ciascuna stringa argomento univoca allo stesso livello o al di sotto di questo oggetto argomento, una sottoscrizione proxy viene inviata in modo asincrono a tutti i gestori code adiacenti nei seguenti scenari:
  • Quando viene creata una sottoscrizione locale.
  • Quando viene ricevuta una sottoscrizione proxy che deve essere propagata ad ulteriori gestori code connessi.
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
Multicast Questa proprietà controlla se l'argomento viene considerato trasmissibile con o senza multicast. Esistono quattro valori possibili:

Come principale. La proprietà multicast dell'argomento viene ereditata dall'elemento principale.

Disabili. Sul nodo non è consentito traffico multicast.

Abilitato. Sul nodo è consentito traffico multicast.

Solo. Sono consentite solo le sottoscrizioni da client abilitati per il multicast.

MCAST
Informazioni di comunicazione Il nome dell'oggetto Informazioni di comunicazione. Poiché nella struttura ad albero esistono più argomenti che richiedono le stesse proprietà di trasmissione multicast, prendere in considerazione l'ipotesi di inserire queste proprietà in un oggetto separato al quale fare riferimento. COMMINFO

Cluster

La seguente tabella elenca le proprietà sulla pagina Cluster della finestra di dialogo IBM MQ Proprietà argomento .
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
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

Statistiche

La seguente tabella elenca le proprietà sulla pagina Statistiche della finestra di dialogo IBM MQ Proprietà argomento .
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.

ALTDATE
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.

ALTTIME