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 utilizzando i comandi MQSC.

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:
TUTTO
La sottoscrizione viene inoltrata a tutti i gestori code direttamente connessi attraverso un collettivo o gerarchia di pubblicazione/sottoscrizione.
QMGR
La sottoscrizione inoltra i messaggi pubblicati sull'argomento solo all'interno di questo gestore code.
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 '000000000000000000000000000000000000000000000000' (48 zeri) il CorrelId impostato dall'applicazione di pubblicazione sarà mantenuto nella copia del messaggio recapitato alla sottoscrizione, a meno che i messaggi non vengano propagati in una gerarchia di pubblicazione/sottoscrizione.

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 o No. Quando Durable è impostato su , 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