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