使用配置管理器连接至配置管理器

开始之前

在开始该步骤之前,您必须已完成配置用于开发和运行配置管理器应用程序的环境

请考虑下列程序 ConnectToConfigManager.java;它试图连接至在本地机器的缺省队列管理器上运行的配置管理器
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);
        }
    }
}

程序的第一行请求 Java 导入 CMP 类。所有 CMP 类都位于 com.ibm.broker.config.proxy 包中。

displayConfigManagerRunState() 方法的 try 块中的第一行实例化 ConfigManagerConnectionParameters 对象。 这是声明实现类能够提供参数以连接至配置管理器的接口。

实现该接口的唯一类是 MQConfigManagerConnectionParameters,它定义了一组基于 WebSphere MQ 的连接参数。此处使用的构造函数采用三个参数:
  1. 配置管理器机器的主机名
  2. 配置管理器WebSphere MQ 侦听器服务正在侦听的端口
  3. 配置管理器WebSphere MQ 队列管理器的名称
定义该对象后,就可以尝试连接具有这些特征的配置管理器队列管理器。这就通过 try 块中的静态 getInstance() 工厂方法实现。一旦获取了配置管理器的有效句柄,则应用程序将试图找到配置管理器的名称(cmp.getName()),并显示该名称。
注: 在提供信息或发生超时之前,getName() 以及从配置管理器请求信息的其他方法都将阻止。

这表示如果配置管理器不在运行,则应用程序将挂起一段时间。通过使用 ConfigManagerProxy.setRetryCharacteristics() 方法可以控制超时周期。 然而,通常只有在应用程序中首次访问给定资源时,才会发生阻止。

最后,调用 disconnect() 方法。该方法释放同时与 CMP 和配置管理器中的连接关联的资源。
注: 当首次从 getInstance() 方法返回 ConfigManagerProxy 句柄时,配置管理器服务无需处于运行中。只有当应用程序试图使用句柄时(在本示例中,通过调用 getName()),应用程序才能确定与配置管理器的双向连接是活动的。
相关任务
配置用于开发和运行配置管理器应用程序的环境
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ae33030_