Prima di iniziare
Prima di eseguire questo passo, è necessario aver completato Connessione a Gestione configurazione mediante il Proxy di Gestione configurazione.
import com.ibm.broker.config.proxy.*; public class SetLongDescription { public static void main(String[] args) { ConfigManagerProxy cmp = null; try { ConfigManagerConnectionParameters cmcp = new MQConfigManagerConnectionParameters( "localhost", 1414, ""); cmp = ConfigManagerProxy.getInstance(cmcp); } catch (ConfigManagerProxyException cmpex) { System.out.println("Error connecting: "+cmpex); } if (cmp != null) { System.out.println("Connected to Config Manager!"); describeBroker(cmp, "B1", "this is my broker"); cmp.disconnect(); } } private static void describeBroker(ConfigManagerProxy cmp, String brokerName, String newDesc) { BrokerProxy b = null; try { TopologyProxy topology = cmp.getTopology(); if (topology != null) { b = topology.getBrokerByName(brokerName); } } catch(ConfigManagerProxyPropertyNotInitializedException ex) { System.err.println("Comms problem! "+ex); } if (b != null) { try { b.setLongDescription(newDesc); } catch (ConfigManagerProxyException ex) { System.err.println("Could not send request to CM: "+ex); } } else { System.err.println("Broker "+brokerName+" not found"); } } }
Properties p = new Properties(); p.setProperty(AttributeConstants.LONG_DESCRIPTION_PROPERTY, newDesc); b.setProperties(p);
Notare che se l'utente corrente non dispone delle autorizzazioni necessarie, durante il funzionamento di SetLongDescription.java non è possibile determinare se la richiesta viene rifiutata da Gestione configurazione. Il metodo CMP per impostare il campo relativo alla descrizione completa genera un'eccezione ConfigManagerProxyException se e solo se il messaggio per eseguire l'operazione non può essere inviato a Gestione configurazione. Ciò significa che l'output del programma è identico, anche se Gestione configurazione non può modificare la proprietà richiesta.
Il motivo è che Gestione configurazione elabora le richieste da CMP in modo asincrono e quindi potrebbe trascorrere un intervallo di tempo considerevole fino a quando l'azione viene eseguita in Gestione configurazione. Se i metodi come quello descritto in questa sezione non restituiscono il controllo al programma fino a quando i codici di completamento non diventano disponibili, le prestazioni dell'applicazione CMP sono totalmente dipendenti dalle prestazioni di Gestione configurazione.
Successivamente:
La progettazione della maggior parte dei metodi CMP per la modifica dello stato è quella di restituire immediatamente senza informare l'applicazione chiamate del risultato della richiesta. Per rilevare tali informazioni, fare riferimento a Verifica dei risultati della gestione del dominio broker mediante Proxy di Gestione configurazione