Conexión a un Gestor de configuración utilizando el Proxy del Gestor de configuración

Antes de empezar

Antes de iniciar este paso, ha de haber completado lo indicado en el apartado Configuración de un entorno para el desarrollo y ejecución de aplicaciones del Proxy del Gestor de configuración.

Vea el siguiente programa ConnectToConfigManager.java; intenta conectar con un Gestor de configuración que se ejecuta en el gestor de colas por omisión de la 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);
        }
    }
}

La primera línea del programa solicita a Java que importe las clases CMP. Todas las clases CMP están en el paquete com.ibm.broker.config.proxy.

La primera línea dentro del bloque try del método displayConfigManagerRunState() crea una instancia del objeto ConfigManagerConnectionParameters. Es una interfaz que indica que las clases de implementación pueden proporcionar los parámetros para conectar a un Gestor de configuración.

La única clase que implementa esta interfaz es MQConfigManagerConnectionParameters, que define un conjunto de parámetros de conexión basados en WebSphere MQ. El constructor utilizado aquí toma tres parámetros:
  1. El nombre del sistema principal de la máquina del Gestor de configuración
  2. El puerto en el que el servicio del escucha WebSphere MQ del Gestor de configuración está a la escucha.
  3. El nombre de gestor de colas WebSphere MQ del Gestor de configuración
Cuando haya definido este objeto, podrá intentar conectar con el gestor de colas del Gestor de configuración con estas características. Esto se lleva a cabo mediante el método de fábrica getInstance() que hay dentro del bloque try. Cuando se obtiene un manejador válido para el Gestor de configuración, la aplicación intenta descubrir el nombre del Gestor de configuración (cmp.getName()) y lo visualiza.
Nota: getName() - y otros métodos que solicitan información del Gestor de configuración - se bloquea hasta que se suministra la información o se produce un tiempo de espera excedido,

Esto significa que si el Gestor de configuración no está ejecutándose, la aplicación se cuelga durante un tiempo. Se puede controlar el periodo de tiempo de espera excedido utilizando el método ConfigManagerProxy.setRetryCharacteristics(). Sin embargo, normalmente, el bloqueo sólo se produce cuando se accede a un recurso dado por primera vez dentro de una aplicación.

Finalmente, se llama al método disconnect(). Este método libera los recursos asociados con la conexión en el CMP y el Gestor de configuración.
Nota: La primera vez que se devuelve el manejador ConfigManagerProxy desde el método getInstance(), es posible que el servicio Gestor de configuración no esté ejecutándose. Únicamente cuando la aplicación intenta utilizar el manejador (llamando a getName() en este ejemplo), la aplicación puede tener la seguridad de que está activa una conexión de dos vías con el Gestor de configuración.
Tareas relacionadas
Configuración de un entorno para el desarrollo y ejecución de aplicaciones del Proxy del Gestor de configuración
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ae33030_