1. 程式人生 > >IBM WebSphere MQ 7.5基本用法

IBM WebSphere MQ 7.5基本用法

所在 linux 方式 exc channel 同步 攔截 nts nec

一、下載7.5 Trial版本

http://www.ibm.com/developerworks/downloads/ws/wmq/

這是下載網址,下載前先必須註冊IBM ID,下載完成後一路Next即可(註:windows上安裝時,會詢問是否域環境,初次學習時,為簡單起見,建議選擇No)

安裝完成後,MQ的Bin目錄會自動添加到環境變量Path中,以後就可以直接用Dos命令行窗口操作(當然,也可以用圖形化GUI方式通過IBM WebSphere MQ Explorer來管理)

註:安裝時,強烈建議用管理員Administrator身份安裝,否則安裝完成後,有可能license無法生效、runmqsc命令模式下無法正常執行命令.

二、創建隊列管理器

WIN + R鍵,輸入cmd,進入命令行窗口,鍵入:

crtmqm QM_TEST

創建一個隊列管理器QM_TEST(你可以改成自己想要的名字),如果把整個MQ理解成一個數據庫實例,QM_TEST相當於就是db instance中的schema(或user)

命令行創建的隊列管理器默認是不活動狀態的,可以用

strmqm QM_TEST

來啟動隊列管理器

三、創建隊列

如果說“隊列管理器”是db中的schema,那麽"隊列"就相當於db中的Table了,而隊列中的每條"消息",就相當於Table中的每條記錄,繼續在命令行窗口模式下,輸入

runmqsc QM_TEST

將進入MQ的交互命令模式,繼續輸入

define qlocal(Q1)

將創建一個本地隊列Q1(你可以改成自己需要的名字),如果此時你打開 "開始菜單->程序->IBM WebSphere MQ->WebSphere MQ Explorer (Installation1)"也能同步在圖形界面下,看到這個隊列

最後鍵入end,退出MQ的交互命令模式。

四、發送消息

繼續在Windows命令模式下,輸入

amqsput Q1 QM_TEST

這裏系統將處於等待用戶輸入的狀態,隨便輸入一些消息,然後連敲二次回車,完成消息發送

五、接收消息

amqsget Q1 QM_TEST

把剛才的put換成了get,將從隊列管理器QM_TEST的隊列Q1中,把消息取出來

六、進階指南

熟悉以上命令行操作後,還可以用圖形化的操作方式再強化一遍(建議還是多用命令行模式,因為有些操作只能用命令行完成,比如後面要提到的修改隊列管理器編碼)

WebSphere MQ Explorer中,從"幫助"菜單裏調出幫助文檔,裏面有一個不錯的教程,強烈推薦新手看一遍

技術分享圖片

不過,"教程2:將消息發送至遠程隊列"這裏,幫助文檔上有幾個細節沒講透,導致初次用命令行照著做,可能會不成功,幾個要點如下:

1、通道命名問題

發送方與接收方的通道名稱,必須一樣,這樣二邊才能對應起來

2、接收方必須要有偵聽器,而且要處於激活狀態

3、發送方的發送通道中,連接名稱格式為:"<接收方HostName或IP地址>(接收方-隊列管理器-偵聽器的TCP端口) ,不包括"<>“,比如比如:yangjm(1514)或172.12.134.14(1514)

4、發送方的發送通道必須處於激活狀態,如果通道啟動失敗,嘗試右鍵->ping/復位,如果還不行,檢查上述要點1-3是否設置有問題

七、遠程連接問題

圖形方式添加“遠程隊列管理器”時,如果遠程隊列也是7.x或以上版本,當前登錄用戶是管理員時,將提示權利不足,拒絕連接,原因是7.0以上,MQ提高了安全性,會默認攔截管理員,詳情可參考IBM上的解釋 http://www-01.ibm.com/support/docview.wss?uid=swg21636532

解決方式:

1. 更換當前用戶,建一個mqm用戶組(MQ安裝後,會默認創建該Windows用戶組)的用戶,然後以該用戶身份登錄操作

2.參考IBM上的解釋,如果出於學習目的,最簡單的做法,就是在runmqsc交互模式下,鍵入

ALTER QMGR CHLAUTH(DISABLED) 直接關閉通道認證(生產環境不推薦這麽做)

另外,要想本機上的隊列能被遠程管理,前提是該隊列管理器允許遠程管理,操作方式:隊列管理器上右擊->選擇"遠程管理...",接下來的事情大家都知道

八、字符集編碼問題

每個隊列管理器,都有一個CCSID的屬性,對應的就是字符集編碼,在windows系統中,這個編碼應該是1381,如果你是用其它OS(比如linux)的配置通過腳本導入MQ的,可能編碼就不是1381了,這會導致在windows上無法連接\啟動隊列管理器,可以通過MQ交互命令行修改,

runmqsc QM_TEST 進入QM_TEST的MQ交互模式

DISPLAY QMGR CCSID 查看當前的CCSID屬性

ALTER QMGR CCSID(1381) 修改字符集編碼為1381

九、如何從“試用版”升級成“正式版”

試用版默認只能用90天,到期後,如果購買了正式版的license,可以通過命令行導入license,命令如下:

setmqprd x:\license\amqpcert.lic

註:amqpcert.lic中的P即代表這是Product生產版本,setmqprd 後面的路徑即為license文件的所在路徑

十、java連接示例代碼

技術分享圖片
import com.ibm.mq.MQC;
import com.ibm.mq.MQEnvironment;
import com.ibm.mq.MQException;
import com.ibm.mq.MQGetMessageOptions;
import com.ibm.mq.MQMessage;
import com.ibm.mq.MQPutMessageOptions;
import com.ibm.mq.MQQueue;
import com.ibm.mq.MQQueueManager;

/*
 * 可以在MQ的資源管理器的某一個隊列上放入測試消息、瀏覽消息等
 * 可以放入多條消息,按先進先出的方式取得
 */
public class MQTest {

    private String qManager;// QueueManager名

    private MQQueueManager qMgr;

    private MQQueue qQueue;

    String HOST_NAME;

    int PORT = 0;

    String Q_NAME;

    String CHANNEL;

    int CCSID;

    String Msg;

    public void init() {

        try {
            HOST_NAME = "yangjm";//Hostname或IP
            PORT = 1414;//要有一個偵聽器,處於活動狀態,且監聽1414端口
            qManager = "QM_APPLE";
            Q_NAME = "Q1";//Q1是一個本地隊列
            CHANNEL = "DC.SVRCONN";//QM_APPLE上要建一個名為DC.SVRCONN的服務器連接通道
            CCSID = 1381; // 表示是簡體中文,
                            // CCSID的值在AIX上一般設為1383,如果要支持GBK則設為1386,在WIN上設為1381。

            
            

            MQEnvironment.hostname = HOST_NAME; // 安裝MQ所在的ip address
            MQEnvironment.port = PORT; // TCP/IP port

            MQEnvironment.channel = CHANNEL;
            MQEnvironment.CCSID = CCSID;

            qMgr = new MQQueueManager(qManager);

            
            int qOptioin = MQC.MQOO_INPUT_AS_Q_DEF | MQC.MQOO_INQUIRE
                    | MQC.MQOO_OUTPUT;

            qQueue = qMgr.accessQueue(Q_NAME, qOptioin);

        } catch (MQException e) {
            System.out
                    .println("A WebSphere MQ error occurred : Completion code "
                            + e.completionCode + " Reason Code is "
                            + e.reasonCode);
        }
    }

    void finalizer() {
        try {
            qQueue.close();
            qMgr.disconnect();
        } catch (MQException e) {
            System.out
                    .println("A WebSphere MQ error occurred : Completion code "
                            + e.completionCode + " Reason Code is "
                            + e.reasonCode);
        }
    }

    /*
     * 取過一次,下次就沒有了
     */
    public void GetMsg() {
        try {
            MQMessage retrievedMessage = new MQMessage();

            MQGetMessageOptions gmo = new MQGetMessageOptions();
            gmo.options += MQC.MQPMO_SYNCPOINT;

            qQueue.get(retrievedMessage, gmo);

            int length = retrievedMessage.getDataLength();

            byte[] msg = new byte[length];

            retrievedMessage.readFully(msg);

            String sMsg = new String(msg);
            System.out.println(sMsg);

        } catch (RuntimeException e) {
            e.printStackTrace();
        } catch (MQException e) {
            if (e.reasonCode != 2033) // 沒有消息
            {
                e.printStackTrace();
                System.out
                        .println("A WebSphere MQ error occurred : Completion code "
                                + e.completionCode
                                + " Reason Code is "
                                + e.reasonCode);
            }
        } catch (java.io.IOException e) {
            System.out
                    .println("An error occurred whilst to the message buffer "
                            + e);
        }
    }

    public void SendMsg(byte[] qByte) {
        try {
            MQMessage qMsg = new MQMessage();
            qMsg.write(qByte);
            MQPutMessageOptions pmo = new MQPutMessageOptions();

            qQueue.put(qMsg, pmo);

            System.out.println("The message is sent!");
            System.out.println("\tThe message is " + new String(qByte, "GBK"));
        } catch (MQException e) {
            System.out
                    .println("A WebSphere MQ error occurred : Completion code "
                            + e.completionCode + " Reason Code is "
                            + e.reasonCode);
        } catch (java.io.IOException e) {
            System.out
                    .println("An error occurred whilst to the message buffer "
                            + e);
        }

    }

    /**
     * @param args
     */
    public static void main(String[] args) {
        
        MQTest mqst = new MQTest();
        mqst.init();
        try {
            mqst.SendMsg("你好,Webshpere MQ 7.5!".getBytes("GBK"));
            mqst.GetMsg();
        } catch (Exception e) {
            e.printStackTrace();
        }
        mqst.finalizer();
    }

}
View Code

需要引用的jar包(在MQ的安裝目錄下都有)

技術分享圖片

附示例源代碼下載地址: http://pan.baidu.com/s/1qWrs9iO

十一、機器之間遷移

如果要在多臺機器上配置相同的隊列管理器,一臺臺機器去創建、設置十分繁瑣,可以用命令

dmpmqcfg -m QM_TEST -A > C:\SCRIPT\QM_TEST_SCRIPT.DUMP

註:其中QM_TEST即為要導出的隊列管理器名稱,而 "QM_TEST_SCRIPT.DUMP"是導出腳本的文件名,可以隨便修改,執行完後會在"C:\SCRIPT\"下生成一個“.dump”的腳本文件,這裏我們借用了管道操作符號">"

在另一臺機器上,先把dump文件復制過去(比如就放在c盤根目錄下),然後按下列步驟執行

crtmqm QM_TEST

strmqm QM_TEST

runmqsc QM_TEST < C:\QM_TEST_SCRIPT.DUMP > C:\QM_TEST_SCRIPT.OUT

這表示runmqsc命令將對 QM_TEST操作,操作的命令來源於腳本文件 C:\QM_TEST_SCRIPT.DUMP,而執行結果會輸出到 C:\QM_TEST_SCRIPT.OUT

出處:http://www.cnblogs.com/yjmyzz/p/3505325.html

IBM WebSphere MQ 7.5基本用法