Proprietà delle sottoscrizioni IBM MQ
È possibile impostare le proprietà per tutti i tipi di sottoscrizione. Alcune proprietà non si applicano a tutti i tipi di sottoscrizioni, mentre altre sono specifiche per le sottoscrizioni z/OS® .
Le seguenti tabelle elencano tutte le proprietà che è possibile impostare:
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 SUB. Per ulteriori informazioni sui comandi MQSC, consultare Amministrazione IBM® MQ mediante i comandi MQSC in IBM Documentation.
Pagina Generale
Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Generale della finestra Proprietà delle sottoscrizioni .
Proprietà | Significato | Parametro MQSC |
---|---|---|
Nome sottoscrizione | Sola lettura. Non è possibile modificare il nome della sottoscrizione dopo averla creata. | SUBNAME |
Nome argomento | Il nome dell'oggetto argomento utilizzato dalla sottoscrizione. Il nome dell'argomento fornisce una root dell'argomento facoltativa. Il numero massimo di caratteri consentiti è 48. | TOPICOBJ |
Stringa argomento | Specifica un nome completo dell'argomento, oppure un carattere jolly di argomento impostato
per la sottoscrizione. Il carattere slash (/) 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 (/). |
TOPICSTR |
Utilizzo caratteri jolly | Lo schema viene utilizzato quando si interpretano i caratteri jolly contenuti nel Topic string. I due valori
sono: caratteri jolly per stringhe ARGOMENTO: rappresentano porzioni della gerarchia dell'argomento. Caratteri jolly per CARATTERI: rappresentano porzioni delle stringhe. |
WSCHEMA |
Ambito | L'ambito determina se questa sottoscrizione viene inoltrata ad altri gestori
code, in modo che il sottoscrittore riceva i messaggi pubblicati presso tali altri gestori code. I due valori
sono:
Nota: i singoli sottoscrittori possono limitare solo SUBSCOPE. Se il parametro è impostato su ALL a livello di
argomento, un singolo sottoscrittore può limitarlo su QMGR per questa
sottoscrizione. Tuttavia, se il parametro è impostato su QMGR a livello di argomento,
l'impostazione di un singolo sottoscrittore su ALL non ha alcune effetto.
|
SUBSCOPE |
Classe di destinazione | La classe di destinazione specifica se la destinazione utilizzata dalla
sottoscrizione è una destinazione gestita. I due valori
sono: GESTITO: la destinazione è gestita. FORNITA: la destinazione è una coda. Questo è il valore predefinito. |
DESTCLAS |
Gestore code di destinazione | Il gestore code di destinazione per i messaggi pubblicati nella sottoscrizione. | DESTQMGR |
Nome destinazione | Specifica il nome della coda alias, locale, remota o cluster in cui vengono inseriti i messaggi per questa sottoscrizione. | DEST |
Identificativo di correlazione | Il valore di Correlation identifier verrà inserito nel descrittore del messaggio di tutti i messaggi inviati alla sottoscrizione. Se non viene specificato alcun parametro Correlation
identifier, i messaggi verranno inseriti nella destinazione con un CorrelId di MQCI_NONE. Un valore vuoto (valore predefinito) determina l'utilizzo di un identificativo di correlazione generato dal sistema. Se impostato su ' |
DESTCORL Nota: non è possibile impostare la proprietà DESTCORL in modo programmatico con JMS.
|
Durevole | Una sottoscrizione duratura non viene eliminata quando l'applicazione che la crea chiude la gestione della sottoscrizione. Il parametro Durable della sottoscrizione può essere Sì o No. Quando Durable è impostato su Sì, le sottoscrizioni non vengono eliminate quando l'applicazione di creazione chiude il suo handle di sottoscrizione. | DURABLE |
Tipo | Il Type di sottoscrizione indica come è stata creata la sottoscrizione. I tipi di sottoscrizione sono: API: sottoscrizione creata tramite una richiesta MQSUB API . ADMIN: sottoscrizione creata tramite un comando DEF SUB MQSC o PCF . ADMIN viene utilizzato anche per indicare che una sottoscrizione è stata modificata utilizzando un comando di gestione. PROXY: sottoscrizione creata internamente per l'instradamento delle pubblicazioni attraverso una rete di gestori code. Le sottoscrizioni del tipo PROXY non vengono modificate in ADMIN quando vengono tentate delle modifiche. L'elemento Type non può essere modificato. |
SUBTYPE |
Proprietà | Properties determina come vengono aggiunte le proprietà del messaggio correlate alla pubblicazione/sottoscrizione ai messaggi inviati alla sottoscrizione. Le opzioni disponibili sono: Compatibilità: le proprietà di pubblicazione/sottoscrizione vengono aggiunte al messaggio per mantenere la compatibilità con la pubblicazione/sottoscrizione di IBM WebSphere® MQ 6.0. Proprietà del messaggio: le proprietà di pubblicazione/sottoscrizione vengono aggiunte come proprietà del messaggio. Nessuno: le proprietà di pubblicazione/sottoscrizione non vengono aggiunte al messaggio. RFH2: le proprietà di pubblicazione/sottoscrizione vengono aggiunte al messaggio all'interno di un'intestazione RFH 2. |
PSPROP |
Dati utente | Il valore di User data può essere opzionalmente passato come proprietà del messaggio in un messaggio inviato alla sottoscrizione. | USERDATA |
Selettore | L'elemento Selector è una stringa SQL92 applicata ai messaggi pubblicati nell'argomento denominato per selezionare se sono idonei per la sottoscrizione. | SELECTOR |
Tipo selettore | Il tipo di SelectionString che è stato specificato. Questa proprietà di visualizzazione viene calcolata e non è associata a un oggetto. Il tipo di selettore sarà filtrabile (ad esempio con una clausola WHERE) per consentire a un amministratore di visualizzare solo selettori interni o solo selettori esterni. | SELTYPE |
Pagina Esteso
Nella seguente tabella sono riportate le proprietà che è possibile impostare nella pagina Esteso della finestra Proprietà delle sottoscrizioni .
Proprietà | Significato | Parametro MQSC |
---|---|---|
ID utente variabile | Specifica se gli utenti diversi dal creatore della sottoscrizione
possono connettersi alla stessa ed assumere la proprietà della sottoscrizione. I due valori
sono: QUALSIASI: gli altri utenti possono connettersi alla sottoscrizione se l'altro utente è in possesso delle verifiche corrette di autorizzazione dell'argomento e della destinazione. Questo è il valore predefinito. FISSO: gli altri utenti non possono connettersi alla sottoscrizione. |
VARUSER |
Utente | Specifica il profilo utente che possiede questa sottoscrizione. | SUBUSER |
Dati identità applicazione | Il valore di Application identity data verrà utilizzato per i messaggi inviati alla sottoscrizione. Se Application identity data non viene specificato, viene utilizzato un valore predefinito vuoto. | PUBAPPID |
Token account | Il valore di Accounting token verrà utilizzato per i messaggi inviati alla sottoscrizione. Se Accounting token non viene specificato, viene utilizzato il valore predefinito MQACT_NONE. | PUBACCT |
Priorità di pubblicazione | L'elemento Publish priority determina il modo in cui vengono aggiunte le proprietà del messaggio correlate alla pubblicazione/sottoscrizione ai messaggi inviati alla sottoscrizione. Le opzioni disponibili sono: Come pubblicato indica la priorità del messaggio inviato a questa sottoscrizione e viene acquisito da quella fornita nel messaggio pubblicato. Come definito dalla coda indica la priorità del messaggio inviato a questa sottoscrizione e viene acquisito dalla priorità predefinita della coda definita come destinazione. Il valore priorità che consente di specificare un priorità compresa tra 0 e 9. |
PUBPRTY |
ID sottoscrizione | Il valore di Subscription ID viene assegnato dal gestore code come identificativo univoco valido per tutto il tempo per l'abbonamento. Questo identificativo può essere utilizzato come un'alternativa a SUBNAME come destinazione per i comandi MQSC DISPLAY, ALTER e DELETE quando non è possibile fornire il SUBNAME a causa del suo formato oppure se non viene fornito alcun SUBNAME per una sottoscrizione creata dall'applicazione. | SUBID |
Scadenza | Il tempo di vita della sottoscrizione, a partire dalla data e dall'ora di creazione. Expiry viene misurato in decimi di secondo. I due valori
sono: Illimitato, che significa che la sottoscrizione non scadrà mai oppure che l'utente può immettere un proprio valore, misurato in decimi di secondo. Zero è il valore predefinito. |
EXPIRY |
Solo richiesta | Solo richiesta indica se il sottoscrittore richiederà aggiornamenti
via MQSUBPRQ API. I due valori
sono: Tutte che significa che tutte le pubblicazioni sono consegnate alla sottoscrizione. Questo è il valore predefinito. Su richiesta che significa che le pubblicazioni sono consegnate alla sottoscrizione soltanto in risposta a MQSUBPRQ API. |
REQONLY |
Livello sottoscrizione | Questo è il livello associato alla sottoscrizione. Le pubblicazioni vengono consegnate solo a questa sottoscrizione se si trova nella serie di sottoscrizioni con il valore SubLevel più alto, minore o uguale del livello PubLevel utilizzato al momento della pubblicazione. Il valore deve essere compreso nell'intervallo 0 - 9. Zero è il livello più basso. | SUBLEVEL |
Pagina Statistiche
Nella seguente tabella sono riportate le proprietà nella pagina Statistiche della finestra Proprietà della sottoscrizione . La pagina Statistiche visualizza le informazioni sulla cronologia dell'elenco nomi. Le informazioni visualizzate nella pagina Statistiche sono di sola lettura e non possono essere modificate dall'utente.
Proprietà | Significato | Parametro MQSC |
---|---|---|
Data di creazione | Sola lettura. Questa è la data in cui è stata creata la sottoscrizione. | CRDATE |
Ora di creazione | Sola lettura. Questa è l'ora in cui è stata creata la sottoscrizione. | CRTIME |
Data di modifica | Sola lettura. Questa è la data dell'ultima modifica delle proprietà della sottoscrizione. | ALTDATE |
Ora modifica | Sola lettura. Questa è l'ora dell'ultima modifica delle proprietà della sottoscrizione. | ALTTIME |