Conectando a um Configuration Manager Utilizando o Configuration Manager Proxy

Antes de começar

Antes de iniciar esta etapa, é necessário ter concluído Configurando um Ambiente para Desenvolvimento e Execução de Aplicativos do Configuration Manager Proxy.

Considere o seguinte programa ConnectToConfigManager.java; ele tenta conectar-se a um Configuration Manager em execução no queue manager padrão da máquina local.
import com.ibm.broker.config.proxy.*;
public class ConfigManagerRunStateChecker {
public static void main(String[] args) {
displayConfigManagerRunState("localhost", 1414, "");
}
public static void displayConfigManagerRunState(String hostname,
int port,
String qmgr) {
ConfigManagerProxy cmp = null;
    try {
ConfigManagerConnectionParameters cmcp =
new MQConfigManagerConnectionParameters(hostname, port, qmgr);
cmp = ConfigManagerProxy.getInstance(cmcp);
String configManagerName = cmp.getName();
System.out.println("Configuration Manager ‘"+configManagerName+
"’ is available!");
cmp.disconnect();
} catch (ConfigManagerProxyException ex) {
System.out.println("Configuration Manager is NOT available"+
" because "+ex);
}
}
}

A primeira linha do programa solicita que Java importe as classes do CMP. Todas as classes do CMP estão no pacote com.ibm.broker.config.proxy.

A primeira linha dentro do bloco try do método displayConfigManagerRunState() instancia um objeto ConfigManagerConnectionParameters. Esta é uma interface que indica que as classes de implementação podem fornecer os parâmetros para conexão com um Configuration Manager.

A única classe que implementa esta interface é MQConfigManagerConnectionParameters, que define um conjunto de parâmetros de conexão baseados no WebSphere MQ. O construtor utilizado aqui utiliza três parâmetros:
  1. O nome do host da máquina do Configuration Manager
  2. A porta na qual o serviço listener do WebSphere MQ do Configuration Manager está atendendo
  3. o nome do queue manager do WebSphere MQ do Configuration Manager
Depois de definir este objeto, pode ser feita uma tentativa de conexão com o queue manager do Configuration Manager com estas características. Isto é obtido pelo método estático do depósito de informações do provedor getInstance() dentro do bloco try. Quando for obtida uma manipulação válida para o Configuration Manager, o aplicativo tentará descobrir o nome do Configuration Manager (cmp.getName()) e exibi-lo.
Nota: getName() - e outros métodos que solicitam informações do Configuration Manager - ficam bloqueados até que as informações sejam fornecidas ou ocorra um tempo limite.

Isto significa que se o Configuration Manager não estiver em execução, o aplicativo será interrompido por um período. É possível controlar o tempo limite utilizando o método ConfigManagerProxy.setRetryCharacteristics(). No entanto, geralmente, o bloqueio ocorre apenas quando um determinado recurso é acessado pela primeira vez em um aplicativo.

Por último, o método disconnect() é chamado. Este método libera recursos associados à conexão no CMP e no Configuration Manager.
Nota: Quando uma manipulação ConfigManagerProxy é retornada pela primeira vez do método getInstance(), o serviço Configuration Manager não está necessariamente em execução. É apenas quando o aplicativo tenta utilizar a manipulação (chamando getName() neste exemplo) que o aplicativo pode ter a garantia de que uma conexão de duas vias com o Configuration Manager está ativa
Tarefas relacionadas
Configurando um Ambiente para Desenvolvimento e Execução de Aplicativos do Configuration Manager Proxy
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
ae33030_