Utilizzo della riconnessione client automatica in ambienti Java SE

Le applicazioni che utilizzano gli ambienti IBM® MQ classes for JMS in esecuzione in Java SE possono utilizzare la funzionalità di riconnessione client automatica tramite la proprietà factory di connessione CLIENTRECONNECTOPTIONS.

La proprietà della factory di connessione CLIENTRECONNECTOPTIONS utilizza due proprietà aggiuntive della factory di connessione, CONNECTIONNAMELIST e CCDTURL, per determinare come connettersi al server su cui è in esecuzione il gestore code.

CONNECTIONNAMELIST proprietà

La proprietà CONNECTIONNAMELIST è un elenco separato da virgole che contiene le informazioni sul nome host e sulla porta da utilizzare per connettersi a un gestore code in modalità client. Questa proprietà viene utilizzata con i valori QMANAGER e CHANNEL . Quando un'applicazione utilizza la proprietà CONNECTIONNAMELIST per creare una connessione client, IBM MQ classes for JMS tenta di connettersi a ogni host in ordine di elenco. Se il primo host del gestore code non è disponibile, IBM MQ classes for JMS tenta di connettersi all'host successivo nell'elenco. Se viene raggiunta la fine dell'elenco dei nomi di connessione senza creare una connessione, IBM MQ classes for JMS genera ilMQRC_QMGR_NOT_AVAILABLECodice di errore IBM MQ .

Se il gestore code a cui è connessa l'applicazione ha esito negativo, le applicazioni che hanno utilizzato un CONNECTIONNAMELIST per connettersi a tale gestore code ricevono un'eccezione che indica che il gestore code non è disponibile. L'applicazione deve rilevare l'eccezione e cancellare tutte le risorse che stava utilizzando. Per creare una connessione, l'applicazione deve utilizzare la factory di connessione. Il factory di connessione tenta di connettersi nuovamente a ogni host in ordine di elenco, il gestore code che ha avuto esito negativo non è ora disponibile. La factory di connessione tenta di connettersi a un altro host nell'elenco.

CCDTURL proprietà

La proprietà CCDTURL contiene un URL Uniform Resource Locator) che punta a una Client Channel Definition Table (CCDT); questa proprietà viene utilizzata insieme alla proprietà QMANAGER. CDT contiene un elenco di canali client utilizzati per connettersi a un gestore code definito su un sistema IBM MQ . Per informazioni su come le CCDT vengono utilizzate da IBM MQ classes for JMS, vedere Utilizzo di una tabella di definizione del canale client con le classi IBM MQ per JMS.

Utilizzo della propriet ... CLIENTRECONNECTOPTIONS per abilitare la riconnessione automatica del client all'interno di IBM MQ classes for JMS

La proprietà CLIENTRECONNECTOPTIONS viene utilizzata per consentire la riconnessione automatica del client in IBM MQ classes for JMS. I valori possibili per questa proprietà sono i seguenti:
ASDEF
Il funzionamento della riconnessione automatica del client è definito dal valore predefinito specificato nella stanza del canale del file di configurazione del client IBM MQ (mqclient.ini).
DISABILITATO
La riconnessione automatica del client è disabilitata.
QMGR
Il IBM MQ classes for JMS tenta di connettersi a un gestore code con lo stesso identificativo del gestore code a cui era connesso, utilizzando una delle seguenti opzioni:
  • La proprietà CONNECTIONNAMELIST e il canale definito nella proprietà CHANNEL .
  • Il CCDT definito nella proprietà CCDTURL .
ANY
Il IBM MQ classes for JMS tenta di riconnettersi a un gestore code con lo stesso nome utilizzando la proprietà CONNECTIONNAMELIST o CCDTURL.