Conectando a um Gerenciador de Configuração 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 gerenciador de fila 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 gerenciador de fila do WebSphere MQ do Configuration Manager
Depois de definir este objeto, pode ser feita uma tentativa de conexão com o gerenciador de fila 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
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ae33030_