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 |
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 |
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:
|
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:
|
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:
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:
|
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:
|
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:
|
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:
|
CLSTATE |
Instradamento cluster | Il comportamento dell'instradamento da utilizzare per gli argomenti nel
cluster definito dal parametro CLUSTER. Esistono due valori possibili:
|
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 |