IBM MQ proprietà di abbonamento
È possibile impostare le proprietà per tutti i tipi di sottoscrizione. Alcune delle proprietà non si applicano a tutti i tipi di abbonamenti, alcune proprietà sono specifiche per gli abbonamenti 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 utilizzando i comandi MQSC in IBM® Documentazione.
Pagina Generale
La seguente tabella elenca le proprietà che è possibile impostare nella pagina Generale della finestra di dialogo Proprietà di Abbonamento .
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 durante l'interpretazione di qualsiasi carattere jolly
contenuto nella Stinga argomento. 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: Gli abbonati individuali 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 del parametro ID di
correlazione verrà inserito nel descrittore del messaggio
di tutti i messaggi inviati alla sottoscrizione. Se non viene specificato alcun parametro ID di
correlazione, i messaggi saranno posizionati sulla destinazione con CorrelId
uguale a 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 programmaticamente con Masi.
|
Durevole | Una sottoscrizione duratura non viene eliminata quando l'applicazione che la crea chiude la gestione della sottoscrizione. Il parametro Durevole della sottoscrizione può essere Sì o No. Quando Durevole è impostato su Sì, le sottoscrizioni non vengono eliminate quando l'applicazione di creazione chiude il suo handle di sottoscrizione. | DURABLE |
Tipo | Il Tipo di sottoscrizione indica la modalità di
creazione della sottoscrizione. I tipi di sottoscrizione sono: API: sottoscrizione creata mediante richiesta MQSUB API. ADMIN: sottoscrizione creata mediante 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. Il Tipo non può essere modificato. |
SUBTYPE |
Proprietà | Le Proprietà determinano in che modo le proprietà dei messaggi relative alla pubblicazione/sottoscrizione
vengano aggiunte ai messaggi inviati alla sottoscrizione. Le opzioni disponibili sono: Compatibilità: Le Proprietà di pubblicazione / sottoscrizione vengono aggiunte al messaggio per mantenere la compatibilità con IBM WebSphere® MQ 6,0 Pubblica / Sottoscrivi. 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 Dati utente può essere facoltativamente trasmesso come proprietà del messaggio in un messaggio inviato alla sottoscrizione. | USERDATA |
Selettore | Il Selettore è una stringa SQL92 applicata ai messaggi pubblicati sull'argomento denominato per selezionare se sono adatti 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
La seguente tabella elenca le proprietà che è possibile impostare nella pagina Extended della finestra di dialogo Proprietà di Abbonamento .
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 del parametro Dati identità applicazione sarà utilizzato per i messaggi inviati alla sottoscrizione. Se Dati identità applicazione non è specificato, viene utilizzato un valore predefinito vuoto. | PUBAPPID |
Token account | Il valore del Token account sarà utilizzato per i messaggi inviati alla sottoscrizione. Se il Token account non è specificato, verrà utilizzato il valore predefinito MQACT_NONE. | PUBACCT |
Priorità di pubblicazione | Le Proprietà di pubblicazione determinano in che modo
le proprietà dei messaggi relative alla pubblicazione/sottoscrizione
vengano aggiunte 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 ID sottoscrizione viene assegnato dal gestore code, in qualità di identificativo univoco della sottoscrizione. 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. La Scadenza si misura
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
La seguente tabella elenca le proprietà sulla pagina Statistiche della finestra di dialogo Proprietà di Abbonamento . 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 |