PROPCTL Opzioni di canale

Utilizzare l'attributo del canale PROPCTL per controllare quali proprietà del messaggio sono incluse in un messaggio inviato dal gestore code IBM® MQ 9.2 a un gestore code partner da una versione precedente di IBM MQ.

Tabella 1. Impostazioni dell'attributo della proprietà del messaggio del canale
PROPCTL Descrizione
tutto

Utilizzare questa opzione se le applicazioni connesse al gestore code partner da una versione precedente sono in grado di elaborare tutte le proprietà inserite in un messaggio da un'applicazione IBM MQ 9.2 .

Tutte le proprietà vengono inviate al gestore code partner, oltre a tutte le coppie nome - valore collocate in MQRFH2.

È necessario considerare due problemi di progettazione dell'applicazione:
  1. Un'applicazione connessa a un gestore code partner deve essere in grado di elaborare i messaggi contenenti intestazioni MQRFH2 generate su un gestore code IBM MQ 9.2 .
  2. L'applicazione connessa al gestore code partner deve elaborare correttamente le nuove proprietà del messaggio contrassegnate con MQPD_SUPPORT_REQUIRED .

Con l'opzione del canale ALL impostata, le applicazioni JMS possono interagire tra IBM MQ 9.2 e una versione precedente utilizzando il canale. Le nuove applicazioni IBM MQ 9.2 che utilizzano le proprietà dei messaggi possono interagire con le applicazioni di una versione precedente, a seconda di come l'applicazione della versione precedente gestisce le intestazioni MQRFH2 .
COMPAT

Utilizzare questa opzione per inviare le proprietà dei messaggi alle applicazioni connesse a un gestore code partner di una versione precedente in alcuni casi, ma non in tutti. Le proprietà del messaggio vengono inviate solo se vengono soddisfatte due condizioni:

  1. Nessuna proprietà deve essere contrassegnata come richiedente l'elaborazione della proprietà del messaggio.
  2. Almeno una delle proprietà del messaggio deve trovarsi in una cartella riservata ; consultare Nota.

Con l'opzione del canale COMPAT impostata, le applicazioni JMS possono interagire tra IBM MQ 9.2 e una versione precedente utilizzando il canale.

Il canale non è disponibile per tutte le applicazioni che utilizzano le proprietà dei messaggi, ma solo per quelle che utilizzano le cartelle riservate. Le regole relative all'invio del messaggio o della proprietà sono:

  1. Se il messaggio dispone di proprietà, ma nessuna delle proprietà è associata a una cartella riservata , non viene inviata alcuna proprietà del messaggio.
  2. Se una proprietà del messaggio è stata creata in una cartella di proprietà riservata , vengono inviate tutte le proprietà del messaggio associate al messaggio. Tuttavia:
    1. Se una delle proprietà del messaggio è contrassegnata come richiesta di supporto, MQPD_SUPPORT_REQUIRED o MQPD_SUPPORT_REQUIRED_IF_LOCAL, l'intero messaggio viene rifiutato. Viene restituito, eliminato o inviato alla coda di messaggi non recapitabili in base al valore delle relative opzioni di report.
    2. Se nessuna proprietà del messaggio è contrassegnata come richiesta, una singola proprietà potrebbe non essere inviata. Se uno dei campi del descrittore della proprietà del messaggio è impostato su valori non predefiniti, la singola proprietà non viene inviata. Il messaggio è ancora inviato. Un esempio di un valore di campo descrittore proprietà non predefinito è MQPD_USER_CONTEXT.
Nota: i nomi delle cartelle riservate iniziano con mcd., jms., usr.o mqext.. Queste cartelle vengono create per applicazioni che utilizzano l'interfaccia JMS . In IBM MQ 9.2 tutte le coppie nome - valore inserite in queste cartelle vengono considerate come proprietà del messaggio.

Le proprietà del messaggio vengono inviate in un'intestazione MQRFH2 , in aggiunta a tutte le coppie nome - valore inserite in un'intestazione MQRFH2 . Tutte le coppie nome - valore inserite in un'intestazione MQRFH2 vengono inviate finché il messaggio non viene rifiutato.
Nessuno

Utilizzare questa opzione per impedire che le proprietà del messaggio vengano inviate alle applicazioni connesse a un gestore code partner di una versione precedente. Un MQRFH2 che contiene coppie nome - valore e proprietà del messaggio viene ancora inviato, ma solo con le coppie nome - valore.

Con l'opzione del canale NONE impostata, un messaggio JMS viene inviato come JMSTextMessage o JMSBytesMessage senza alcuna proprietà del messaggio JMS . Se un'applicazione di una versione precedente può ignorare tutte le proprietà impostate in un'applicazione IBM MQ 9.2 , può interagire con essa.