Conectando a um Configuration Manager Utilizando o Configuration Manager Proxy

Conectar um aplicativo do CMP a um Configuration Manager para enviar pedidos sobre recursos no domínio do intermediário.

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 que esteja 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. Este método é uma interface que indica que as classes de implementação podem fornecer os parâmetros para conectar-se a um Configuration Manager.

A única classe que implementa esta interface é MQConfigManagerConnectionParameters, que define um conjunto de parâmetros de conexão do 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 para o Configuration Manager está atendendo
  3. O nome do gerenciador de fila que está associado ao Configuration Manager

Quando tiver definido este objeto, você poderá conectar-se ao gerenciador de fila com essas características. A conexão é obtida pelo método do gerador de getInstance() estático que se encontra dentro do bloco try. Quando um identificador válido para o Configuration Manager é obtido, o aplicativo tenta descobrir o nome do Configuration Manager (cmp.getName()) e exibi-lo.

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. Portanto, se o Configuration Manager não estiver em execução, o aplicativo ficará interrompido por um período. Você pode controlar o tempo limite utilizando o método ConfigManagerProxy.setRetryCharacteristics(). 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.

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. E apenas quando o aplicativo tenta utilizar o identificador (chamando getName() neste exemplo) que o aplicativo pode ter certeza de que uma conexão bidirecional com o Configuration Manager está ativa.

Tarefas relacionadas
Configurando um Ambiente para Desenvolvimento e Execução de Aplicativos do Configuration Manager Proxy
Informações relacionadas
API do Configuration Manager Proxy
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:23

ae33030_