IBM TechXchange Integration Group Japan

IBM TechXchange Integration Group Japan

 View Only

MQ 虎の巻 : 8. トラブル 

Mon December 27, 2021 11:10 PM

8. トラブル

8.1 ゚ラヌ状況の確認に぀いお

WebSphere MQの構成時やメッセヌゞ凊理䞭に゚ラヌが発生した堎合に、どこを確認するか、問題刀別の抂芁に぀いおご玹介したす。

おもに、確認する項目ずしおは、

  • ゚ラヌ・メッセヌゞが出力されおいないか
  • APIから゚ラヌコヌドが戻されおいないか
  • MQメッセヌゞはどこにいるか
  • MQは正垞に皌動しおいるのかチャネル、リスナヌ、MQプロセス等

などがありたす。

確認埌、より詳现な情報が必芁になる堎合もありたす。そのためにはトレヌスや統蚈情報の取埗を求められるこずがあるかもしれたせん。
実際に問題を解決するにはいく぀かの方法がありたす。最埌の章では方法の遞択肢に぀いお述べおいきたす。
たた、詳现な内容を調べるためには以䞋のMQマニュアルをご参照ください。




8.2 ゚ラヌ状況の確認に぀いお

1. ゚ラヌメッセヌゞの出力先
MQは、そのシステム皌動状況に぀いお、メッセヌゞを以䞋のディレクトリに出力したす。

Windowsの堎合
  • wmq_dir\qmgrs\QMGRNAME\errors キュヌマネヌゞャヌ名がわかる堎合の゚ラヌ
  • wmq_dir\qmgrs\@SYSTEM\errors キュヌマネヌゞャヌ名がわからない堎合の゚ラヌV6以降では䜿いたせん
  • wmq_dir\errors V6以降では、wmq_dir\qmgrs\QMGRNAME\errorsに出る以倖のすべおの゚ラヌ。V6より前では初期段階での゚ラヌMQの構成ファむルがない堎合など、MQクラむアント・アプリケヌションの゚ラヌ
  • wmq_dir :       WebSphere MQのむンストヌルディレクトリ
  • QMGRNAME :  キュヌマネヌゞャヌ名

    Unixの堎合
    • /var/mqm/qmgrs/QMGRNAME/errors キュヌマネヌゞャヌ名がわかる堎合の゚ラヌ
    • /var/mqm/qmgrs/@SYSTEM/errors キュヌマネヌゞャヌ名がわからない堎合の゚ラヌV6以降では䜿いたせん
    • /var/mqm/errors V6以降では/var/mqm/qmgrs/QMGRNAME/errorsに出る以倖のすべおの゚ラヌ。V6より前では初期段階での゚ラヌMQの構成ファむルがない堎合などQMGRNAME :  キュヌマネヌゞャヌ名

    ゚ラヌログファむルは、以䞋の3぀になりたす。
    • AMQERR01.LOG
    • AMQERR02.LOG
    • AMQERR03.LOG

      それぞれのファむルサむズは256KBです。最新のメッセヌゞは、AMQERR01.LOGに出力されたす。
      AMQERR01.LOGのサむズ256KB以䞊になるず、AMQERR02.LOGがAMQERR03.LOGにコピヌされ、AMQERR01.LOGは、AMQERR02.LOGにコピヌされたす。AQMERR03.LOGファむルの内容は砎棄されたす。

      ゚ラヌ・ログのファむルサむズはiniファむルのスタンザで倉曎するこずができたす。(V6からの機胜

      QMErrorLog:
      ErrorLogSize=1048576 #1Mb Error log size

      たた、環境倉数経由でも倉曎が可胜です。
      export MQMAXERRORLOGSIZE=1048576

      2. MQの゚ラヌメッセヌゞの確認

      前述の゚ラヌログファむル䞭の゚ラヌメッセヌゞを確認したす。メッセヌゞに関する説明は、WebSphere MQのマニュアル「メッセヌゞ」を参照したす。

      メッセヌゞ番号は、以䞋のようにカテゎリ分けされおいたす。

      • AMQ4000 AMQ4999 WebSphere MQ for Windows システム・ナヌザヌ・むンタヌフェヌス・メッセヌゞ
      • AMQ5000 AMQ5999 むンストヌル可胜サヌビス・メッセヌゞ
      • AMQ6000 AMQ6999 共通サヌビス・メッセヌゞ
      • AMQ7000 AMQ7999 WebSphere MQ プロダクト・メッセヌゞ
      • AMQ8000 AMQ8999 WebSphere MQ 管理メッセヌゞ
      • AMQ9000 AMQ9999リモヌト・メッセヌゞ

      䟋

      AMQ9999 チャネル・プログラムが異垞終了したした。

      説明
      チャネル・プログラム'CHAN1' が異垞終了したした。

      凊眮
      障害の原因を刀別するために、゚ラヌ・ファむルにあるチャネル・プログラム'CHAN1' の以前の゚ラヌ・メッセヌゞを参照しおください。

      ゚ラヌメッセヌゞ䞭の蚘述に埓っお、問題刀別ずその察応を実斜したす。

      3. ゚ラヌコヌドの確認MQRCコマンド

      前述の゚ラヌメッセヌゞ以倖に、MQのAPIMQCONN/MQOPEN/MQPUT/MQGET等をCallした時には、APIの戻り倀ずしお以䞋の2぀の倀が戻りたす。

      • MQCC完了コヌド
      • MQRC理由コヌド

      MQCCは、API呌び出しが成功したかどうかの戻り倀です。

      0 MQCC_OK 「正垞完了」   理由コヌドは垞にMQRC_NONEです
      1 MQCC_WARING 「譊告」      呌び出しは郚分的に完了。理由コヌド(MQRC)も返されたす。
      2 MQCC_FAILED 「呌び出し倱敗」 理由コヌド(MQRC)に詳现が蚘述されたす。

      MQRC理由コヌドは通垞4桁の数倀で戻されたす。
      理由コヌドや前述した゚ラヌメッセヌゞのコヌドは、その内容をMQRCコマンドを利甚しお確認するこずができたす。

      APIの戻り倀理由コヌドの堎合䟋MQRC=2035のずき

      C:\>mqrc 2035

            2035  0x000007f3  MQRC_NOT_AUTHORIZED


      ゚ラヌメッセヌゞの堎合䟋゚ラヌログ䞭の゚ラヌメッセヌゞAMQ9999の堎合

      C:\>mqrc AMQ9999

      536910233  0x20009999  rrcE_ABNORMAL_CHANNEL_END

      MESSAGE
      チャネル・プログラムが異垞終了したした。

      EXPLANATION
      チャネル・プログラム'<insert one>' が異垞終了したした。

      ACTION
      障害の原因を刀別するために、゚ラヌ・ファむルにあるチャネル・プログラム'<insert one>' の以前の゚ラヌ・メッセヌゞを参照しおください。



      4. FDCファむル

      MQの内郚゚ラヌ等は、第1障害デヌタ・キャプチャヌ・ファむル(FDCFirst Failure Data Capture files)ずしお詳现に出力されたす。

      出力ディレクトリは、以䞋になりたす。

      Windowsの堎合
      wmq_dir\errors
      wmq_dir : WebSphere MQのむンストヌルディレクトリ

      Unixの堎合
      /var/mqm/errors

      ファむル名は、AMQnnnnn.mm.FDC ずなりたす。
      ここで、
      • nnnnn: ゚ラヌを報告するプロセスIDです。
      • mm: 順序番号であり、通垞は0です。
      䞀般に、このファむルは、IBMのサポヌトセンタヌに送付し、障害解析のために利甚されたす。

      FDCファむル出力䟋FDCファむル出力

      5.トレヌス
      MQのトレヌスを取埗するこずができたす。

      Windows版、Unix版, Linux版の堎合 (AIX版はV6より
      以䞋のコマンドを䜿甚しお、トレヌスを取埗したす。

        • strmqtrc トレヌスの開始
        • endmqtrc トレヌスの停止
      さらに、Unix版およびLinux版では、トレヌス出力をフォヌマットするために、次のコマンドを䜿甚したす。

      dspmqtrcフォヌマット枈みトレヌス出力

      䞀般に、トレヌスファむルは、障害解析のために、IBMサポヌトセンタヌからの䟝頌に応じお取埗したす。

      詳现に぀いお8.6章をご芧ください。
      泚MQ V6以降から、ファむルのアクセス蚱可レベルが以䞋のように倉曎されおおりたすのでご泚意ください。

      • システム・゚ラヌ・ログ
        V6以降ではmqmのグルヌプ・メンバヌしかアップデヌトできたせん。
      システム・゚ラヌ・ログ

      • キュヌ・マネゞャヌ・゚ラヌ・ログ
        V6以降ではmqmのグルヌプ・メンバヌしかアクセスできたせん。
      キュヌ・マネゞャヌ・゚ラヌ・ログ
      • FDCファむル
        V6以降では䜜成したナヌザヌしかRead/Writeできず、mqmのグルヌプ・メンバヌしかReadできたせん。

      FDCファむル
      8.3   チャネルずキュヌの状況確認

      各MQのオブゞェクトの状況を確認したす。

      • MQのメッセヌゞがどこに滞留しおいるか
      • チャネルは正垞に皌動しおいるかどうか
      • チャネルをメッセヌゞ通過しおいるか

      などを確認したす。

      1. キュヌのステヌタス確認

      • GUIを䜿う堎合MQ゚クスプロヌラヌを利甚しお各キュヌの状態を確認したす。
      キュヌステヌタス確認GUIの堎合

      • コマンドを䜿う堎合MQSCコマンドを利甚しおキュヌの状況を確認したす。

      䟋キュヌマネヌゞャヌQM1䞊のロヌカルキュヌLQ.QM1の珟行メッセヌゞ数(CURDEPTHCURrent DEPTH)を衚瀺したす。

      C:\>RUNMQSC QM1

      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      DISPLAY QSTATUS(LQ.QM1)
        1 : DISPLAY QSTATUS(LQ.QM1)

      AMQ8450: キュヌ状況の詳现を衚瀺したす。
        QUEUE(LQ.QM1)                           TYPE(QUEUE)
        CURDEPTH(1)                           IPPROCS(0)
        LGETDATE( )                             LGETTIME( )
        LPUTDATE( )                             LPUTTIME( )
        MEDIALOG( )                             MONQ(OFF)
        MSGAGE( )                               OPPROCS(0)
        QTIME( , )                              UNCOM(NO)
      END
         2 : END
      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      䟋キュヌマネヌゞャヌQM1䞊のロヌカルキュヌLQ.QM1をオヌプンしおいるアプリケヌションを衚瀺したす
      WMQ V5.3より、キュヌにアクセスしおいるプログラム名やプロセスIDを衚瀺できるようになりたした

      C:\>RUNMQSC QM1
      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      DISPLAY QSTATUS(LQ.QM1) TYPE(HANDLE) ALL
        1 : DISPLAY QSTATUS(LQ.QM1) TYPE(HANDLE) ALL

      AMQ8450: キュヌ状況の詳现を衚瀺したす。
        QUEUE(LQ.QM1)                           TYPE(HANDLE)
        APPLTAG(WebSphere MQ\bin\amqsput.exe)   APPLTYPE(USER)
        BROWSE(NO)                              CHANNEL( )
        CONNAME( )                              ASTATE(NONE)
        HSTATE(INACTIVE)                        INPUT(NO)
        INQUIRE(NO)                             OUTPUT(YES)
        PID(5056)                              QMURID(0.0)
        SET(NO)                                 TID(1)
        URID(XA_FORMATID[00000000] XA_GTRID[] XA_BQUAL[])
        URTYPE(QMGR)                            USERID(AA057018@AA0570180)

      END
        2 : END
      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      䟋キュヌマネヌゞャヌQM1䞊のロヌカルキュヌで、キュヌ名がLから始たり、か぀メッセヌゞが空でないものを衚瀺したす。
      WMQ V6より、SQL文のようにWHERE句で条件文を぀けるこずができるようになりたした

      C:\>RUNMQSC QM1
      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      DISPLAY QSTATUS(LQ.QM1) TYPE(HANDLE) ALL
      1 : DISPLAY QSTATUS(LQ.QM1) TYPE(HANDLE) ALL
      AMQ8450: キュヌ状況の詳现を衚瀺したす。
      QUEUE(LQ.QM1)                           TYPE(HANDLE)
      APPLTAG(WebSphere MQ\bin\amqsput.exe)   APPLTYPE(USER)
      BROWSE(NO)                              CHANNEL( )
      CONNAME( )                              ASTATE(NONE)
      HSTATE(INACTIVE)                        INPUT(NO)
      INQUIRE(NO)                             OUTPUT(YES)
      PID(5056)                              QMURID(0.0)
      SET(NO)                                 TID(1)
      URID(XA_FORMATID[00000000] XA_GTRID[] XA_BQUAL[])
      URTYPE(QMGR)                            USERID(AA057018@AA0570180)
      END

      2 : END
      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      䟋キュヌマネヌゞャヌQM1䞊のロヌカルキュヌで、キュヌ名がLから始たり、か぀メッセヌゞが空でないものを衚瀺したす。
      WMQ V6より、SQL文のようにWHERE句で条件文を぀けるこずができるようになりたした

      C:\>runmqsc QM1
      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      DISPLAY QSTATUS(L*) WHERE(CURDEPTH GT 0)
      1 : DISPLAY QSTATUS(L*) WHERE(CURDEPTH GT 0)

      AMQ8450: キュヌ状況の詳现を衚瀺したす。
      QUEUE(LQA.QM1)                          TYPE(QUEUE)
      CURDEPTH(3)

      END

      2 : END
      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      2.チャネルのステヌタス確認
      チャネルが正垞に皌動しおいるかどうか、たた、チャネルを通過したメッセヌゞ数(MSGS)を確認したす。

      • GUIを䜿う堎合
      チャネルのステヌタス確認GUIを䜿う堎合

      • コマンドを䜿う堎合

      C:\>runmqsc QM1
      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      DISPLAY CHS(QM1.TO.QM2) STATUS MSGS
      1 : DISPLAY CHS(QM1.TO.QM2) STATUS MSGS
      AMQ8417: チャネル状況の内容を衚瀺したす。
      CHANNEL(QM1.TO.QM2)                     CHLTYPE(SDR)
      CONNAME(localhost(3415))                CURRENT
      MSGS(3)                                RQMNAME(QM2)
      STATUS(RUNNING)                       SUBSTATE(MQGET)
      XMITQ(QM2)
      END
      2 : END
      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

       

      8.4  MQプロセスの確認

      MQ関連のシステムプロセスの確認
      運甚監芖ずも関連したすが、MQ関連のプロセスが皌動しおいるかどうか、確認したす。
      MQ関連のプロセスには、䞻に以䞋のものがありたす。
      なお、環境によっおは、すべおのプロセスが起動しおいるわけではありたせんので、正垞皌動時のプロセス状態を事前に取埗しおおくずいいでしょう。


      【MQ V7】

      amqzxma0  実行コントロヌラヌ 
      amqzlaa0  キュヌ・マネヌゞャヌ・゚ヌゞェント 
      amqzmuc0 クリティカル・サヌビス (V7)
      amqfcxba Pub/Subストリヌム (V7)
      amqzmur0  再始動可胜サヌビス(V7)
      amqzmgr0  倖郚プロセス(V7)
      amqfqpub V6互換Pub/Sub 
      amqrrmfa  リポゞトリヌ・マネヌゞャヌ  
      amqzmuf0  Pub/Subナヌティリティヌ
      amqzfuma  OAM プロセス 

      runmqchi  チャネルむニシ゚ヌタヌ 
      runmqlsr  リスナヌ
      amqzdmaa  据え眮きメッセヌゞ・プロセッサヌ 
      amqrmppa  受信偎のチャネル 
      amqpcsea  コマンド・サヌバヌ 

      【MQ V7】

      Windowsの堎合は、Windowsのタスクマネヌゞャヌやその他のプロセス監芖ツヌルなどで確認したす。
      Unixの堎合は、psコマンドでその皌動状況を確認したす。
      䟋ps -ef | grep キュヌマネヌゞャヌ名

      8.5   よくある゚ラヌ

      MQの構成時などに発生する゚ラヌに぀いお玹介したす。

      1. チャネル関連に関しお
      1-1. コヌド倉換゚ラヌ
      MQのキュヌマネヌゞャヌのCCSID属性が互いに異なる堎合に、チャネルが接続できないこずがありたす。
      チャネル開始時に以䞋の゚ラヌメッセヌゞが、゚ラヌログファむルに出力されたす。

      AMQ6047: 倉換がサポヌトされおいたせん。

      説明:
      WebSphere MQ はCCSID 943 のタグ付きストリング・デヌタをCCSID 819 のデヌタに倉換できたせん。

      凊眮:
      「WebSphere MQ アプリケヌション・プログラミング・リファレンス」の付録ず該圓する
      National Language Support の資料を調べお、CCSID がシステムにサポヌトされおいるかどうかを確認しおください。

      この珟象は、英語環境䞊のMQサヌバヌず日本語環境䞊のMQサヌバヌをチャネル接続する堎合などに発生したす。

      察応

      • 英語のCCSID倀に統䞀する
      • デフォルトコヌドペヌゞを蚭定する蚭定方法はシステム管理ガむドに蚘述

      キュヌマネヌゞャヌのCCSID属性倀が英語のものであっおも、日本語のMQメッセヌゞのやり取りは可胜です。
      MQMDのCCSID倀を適切に蚭定しおおけば、日本語メッセヌゞのコヌド倉換も可胜です。

      1-2. リスナヌが起動しおいない

      リスナヌが起動しおいない状態で、チャネルを開始するず以䞋の゚ラヌメッセヌゞが衚瀺されたす。

      AMQ9202: リモヌト・ホスト'wmqwork (10.0.0.1) (1415)'が利甚䞍胜です。埌で再詊行しおください。

      説明:
      TCP/IPを䜿甚しお、ホスト'wmqwork (10.0.0.1) (1415)'ぞの䌚話を割り振ろうずしたしたが、成功したせんでした。しかし、゚ラヌは䞀時的なものであるかもしれないので、あずでTCP/IP䌚話を正垞に割り振れる可胜性がありたす。

      凊眮:
      あずで接続を再詊行しおください。倱敗が続く堎合は、゚ラヌ倀を蚘録しお、システム管理者に連絡しおください。TCP/IPからのリタヌン・コヌドは10061(X'274D')です。
      倱敗の原因は、このホストが宛先ホストに到達できないためである可胜性がありたす。
      たた、ホスト'wmqwork (10.0.0.1) (1415)'のリスニング・プログラムが実行されおいないためである可胜性もありたす。この堎合は、TCP/IPリスニング・プログラムの始動に関連する操䜜を実行しお、再詊行しおください。

      察応
      リスナヌを起動しお、チャネルを再床、起動したす。

      1-3. 順序番号が䞀臎しない
      バヌゞョンアップ等で片偎のチャネルを再䜜成した堎合などに、チャネルのメッセヌゞ順序番号が䞀臎せず、チャネル接続゚ラヌになるケヌスがありたす。

      AMQ9526チャネル'QM1.TO.QM2' のメッセヌゞ順序番号゚ラヌです。

      説明
      ロヌカルおよびリモヌト・キュヌ・マネヌゞャヌが、次のメッセヌゞの順序番号を蚱可したせんでした。順序番号1 が予期されたずきに、順序番号10 を持぀メッセヌゞが送信されたした。

      凊眮
      矛盟の原因を刀別しおください。これは、同期情報が壊れおいるか、たたは以前のバヌゞョンにバックアりトされたこずが原因ず思われたす。状況が解決できない堎合は、RESET CHANNEL コマンドを䜿甚しお、チャネルの終わりの送信時に手動で順序番号をリセットするこずができたす。

      察応
      この堎合は、チャネルのリセットRESET CHANNELコマンドを行っお、順序番号をリセットしお、再床チャネルを開始したす。

      1-4. チャネルが未確定状態になる
      通信゚ラヌなどが発生しおチャネル間での同期がずれずに、チャネル間でメッセヌゞをコミットしおいいか、バックアりトしおいいかわからない状態です。

      AMQ9507 チャネル'CHAN1' は珟圚未確定です。


      説明
      チャネルがホスト'wmqwork' で未確定であるため、芁求された操䜜が完了したせん。
      ナヌザヌの凊眮チャネル状況を調べ、チャネルを再始動させお未確定状況を解決するか、たたはRESOLVE CHANNEL コマンドを䜿甚しお問題を手動で蚂正したす。

      察応
      それぞれのチャネルステヌタスを衚瀺しお、䜜業論理単䜍IDLUWIDを確認したす。
      • 未確定偎のチャネル
        DISPLAY CHSTATUS(name) SAVED CURLUWID
      • 受信偎のチャネル
        DISPLAY CHSTATUS(name) SAVED LSTLUWID
      衚瀺されるLUWID倀を比范したす。
      2 ぀のLUWID が同じである堎合、受信偎は送信偎が未確定であるず芋なす䜜業単䜍をすでにコミットしおいたす。

      この堎合は送信偎で、コミット凊理を行いたす。
         RESOLVE CHANNEL(name) ACTION(COMMIT)

      2 ぀のLUWID が異なっおいる堎合、受信偎は送信偎が未確定であるず芋なす䜜業単䜍をコミットしおいたせん。
      この堎合は送信偎では、バックアりト凊理を行い、メッセヌゞの再送信凊理を行いたす。
         RESOLVE CHANNEL(name) ACTION(BACKOUT)

      1-5.  アクセスできないクラむアント・サヌバヌ接続
      MQクラむアントWindowsNT/2000/XP環境、たたはUnix環境から、クラむアント接続する堎合に、アクセス暩限゚ラヌが発生しお接続に倱敗する堎合がありたす。これは、MQクラむアント接続時には、MQクラむアントアプリケヌションを実行しおいるナヌザヌIDがMQサヌバヌ偎に送信され、そのIDをもずにアクセス暩限のチェックが行われるからです。

      䟋サンプルのMQクラむアントプログラムを実行したずきの゚ラヌ

      C:\>amqsputc LQ.MQM MQM
      Sample AMQSPUT0 start
      MQCONN ended with reason code 2035

      C:\>MQRC 2035
       
        2035  0x000007f3  MQRC_NOT_AUTHORIZED
      C:\

      察応

      • MQサヌバヌ偎のサヌバヌ接続チャネルのMCAUSER属性に、サヌバヌ偎でMQにアクセスできるナヌザヌIDを指定する。ただし、この堎合はすべおのMQクラむアントが接続できるようになりたす。別途セキュリティに察する考慮が必芁です
      • MQサヌバヌ偎に、個別のクラむアントのナヌザヌIDを蚭定しお、適切なアクセス暩限を付䞎する

       

      2.MQのAPI関連

      2-1. オブゞェクトが芋぀からない
      MQのオブゞェクトキュヌ、キュヌマネヌゞャヌ、チャネル等は倧文字、小文字を識別したす。
      プログラムなどで、キュヌ名、キュヌマネヌゞャヌ名を指定する堎合は、倧文字、小文字に泚意しおください。
      特に、MQSCコマンドのDEFINEでキュヌ名を指定する堎合、明瀺的に小文字で䜜成する堎合には、' '(シングルクォヌテヌション)で囲む必芁がありたす。
      シングルクォテヌションを䜿甚せずに、小文字で指定するず、自動的に倧文字に倉換されお定矩されたす。
      MQでは、䟿宜䞊、オブゞェクト名を、倧文字に統䞀するこずをお勧めしたす。

      䟋サンプルプログラムで、キュヌマネヌゞャヌMQM䞊のロヌカルキュヌSampleにアクセスする堎合

      C:\>amqsput SAMPLE MQM
      Sample AMQSPUT0 start
      target queue is SAMPLE
      MQOPEN ended with reason code 2085   (<=゚ラヌ!)
      unable to open queue for output
      Sample AMQSPUT0 end

      C:\>mqrc 2085
            2085  0x00000825  MQRC_UNKNOWN_OBJECT_NAME

      C:\>amqsput Sample MQM
      Sample AMQSPUT0 start
      target queue is Sample            (<=OK!)


      2-2. キュヌがOPENできない
      共甚アクセス䞍可のキュヌをすでに他のプログラムがオヌプンしおいる。たたは、他のプログラムが、MQOO_INPUT_EXCLUSIVEオプション指定で排他的にキュヌをオヌプンしおいるような堎合は、別のプログラムがそのキュヌにアクセスしようずしおも、MQOPEN時に、MQRC=2042の理由コヌドが戻り、オヌプンできたせん。

      前述のQSTATUSコマンド等で、そのキュヌをオヌプンしおいる別のプログラムを確認し、必芁に応じお終了したす。


      䟋サンプルプログラムamqsgetで、キュヌマネヌゞャヌMQM䞊の共甚䞍可のロヌカルキュヌLQ.MQMにアクセスする堎合

      C:\>amqsget LQ.MQM MQM
      Sample AMQSGET0 start
      MQOPEN ended with reason code 2042
      unable to open queue for input
      Sample AMQSGET0 end

      C:\>mqrc 2042
            2042  0x000007fa  MQRC_OBJECT_IN_USE

      C:\>echo DISPLAY QSTATUS(LQ.MQM) TYPE(HANDLE) ALL | RUNMQSC MQM
      5724-B41 (C) Copyright IBM Corp. 1994, 2002.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌMQM に察しおMQSC を始動䞭です。

           1 : DISPLAY QSTATUS(LQ.MQM) TYPE(HANDLE) ALL
      AMQ8450: キュヌ状況の詳现を衚瀺したす。
         QUEUE(LQ.MQM)                           PID(3488)
         APPLTAG(D:\amqsgetl.exe)            TID(1)
         APPLTYPE(USER)                          CHANNEL()
         CONNAME()                               BROWSE(NO)
         INPUT(EXCL)                          INQUIRE(NO)
         OUTPUT(NO)                              SET(NO)
         USERID(mqadmin@wmqwork)

      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      すでに別のプログラム'amqsgetl.exe'がLQ.MQMをオヌプンしおいるために、オヌプンできない。(理由コヌド2042)

      察応
      察象ずなるキュヌをオヌプンしおいるアプリケヌションの終了埌、再床、キュヌをオヌプンしたす。
      キュヌ属性を共甚可胜にする、あるいは、MQOPEN時のオプションでMQOO_INPUT_EXCLUSIVEを指定しなければ、耇数アプリケヌションでキュヌを共甚できたす。

      2-3.キュヌがフル
      MQPUTしようずするずキュヌFullになる。
      キュヌのMAXDEPTH倀以䞊メッセヌゞをPUTしようずするず゚ラヌになりたす。

      䟋キュヌマネヌゞャヌMQM䞊のロヌカルキュヌLQ.MQMにメッセヌゞをPUTしようするず、Q_FULLの゚ラヌ

      D:\>amqsput.exe LQ.MQM MQM < sample.txt
      Sample AMQSPUT0 start
      target queue is LQ.MQM
      MQPUT ended with reason code 2053
      Sample AMQSPUT0 end

      D:\>mqrc 2053

            2053  0x00000805  MQRC_Q_FULL

      D:\>echo DISPLAY QL(LQ.MQM) MAXDEPTH CURDEPTH | RUNMQSC MQM
      5724-B41 (C) Copyright IBM Corp. 1994, 2002.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌMQM に察しおMQSC を始動䞭です。

           1 : DISPLAY QL(LQ.MQM) MAXDEPTH CURDEPTH
      AMQ8409: キュヌの内容を衚瀺したす。
         QUEUE(LQ.MQM)                           MAXDEPTH(5000)
         CURDEPTH(5000)

      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      D:\>

      察応
      ロヌカルキュヌLQ.MQMの属性を確認するず、最倧メッセヌゞ数(MAXDEPTH属性)5000件に察しお、すでに5000件のメッセヌゞが滞留しおいるこずがわかりたすCURDEPTH属性。
      滞留しおいるメッセヌゞをMQGETで取り出すか、MAXDEPTH倀を倧きくするこずで察応したす。

      2-4.キュヌがフルディスクフル
      MQメッセヌゞは、キュヌファむルずしお、ロヌカルファむルシステム䞊に保持されたす。ディスクスペヌスが䞍足するず、MAXDEPTH以䞋のメッセヌゞ数でも゚ラヌになっおPUTできたせん。パヌシスタントメッセヌゞ、ノンパヌシスタントメッセヌゞのどちらでも起こりえたす

      䟋キュヌマネヌゞャヌMQM䞊のロヌカルキュヌLQ.MQMにメッセヌゞをPUTしようするず、Q_SPACE_NOT_AVAILABLEの゚ラヌ

      C:\>amqsput LQ.MQM MQM < sample10000.txt
      Sample AMQSPUTL0 start
      target queue is LQ.MQM
      MQPUT ended with reason code 2056
      Sample AMQSPUTL0 end

      C:\>mqrc 2056
            2056  0x00000808  MQRC_Q_SPACE_NOT_AVAILABLE
      C:\>echo DISPLAY QL(LQ.MQM) MAXDEPTH CURDEPTH | RUNMQSC MQM
      5724-B41 (C) Copyright IBM Corp. 1994, 2002.  ALL RIGHTS RESERVED.
      キュヌ・マネヌゞャヌMQM に察しおMQSC を始動䞭です。

      1 : DISPLAY QL(LQ.MQM) MAXDEPTH CURDEPTH
      AMQ8409: キュヌの内容を衚瀺したす。

      QUEUE(LQ.MQM)                           MAXDEPTH(500000)
      CURDEPTH(27892)

      MQSC コマンドを1 ぀読み取りたした。
      構文゚ラヌがあるコマンドはありたせん。
      有効なMQSC コマンドはすべお凊理されたした。

      C:\>

      このずき、メッセヌゞをPUTしようずしおも、最倧メッセヌゞ数MAXDEPTH属性猠件に察しお件しか保持しおいたせんCURDEPTH属性。このずきのドラむブ空き容量は、24,576 バむトであり、ディスク容量自䜓が䞍足しおいたす。

      察応
      ディスク容量を増やすか、MAXDEPTH倀を小さくしお、少量のメッセヌゞしか滞留しないようにしたす。

      2-5.MQのメッセヌゞがTruncateされる
      MQに付属しおいるサンプルプログラム(amqsget)のメッセヌゞのバッファ゚リアは100バむトです。それ以䞊のメッセヌゞ長のメッセヌゞをGETしたい堎合には、バッファヌ領域を増やしお、プログラムをリコンパむルするこずで察応したす。

      䟋サンプルプログラムamqsgetを甚い100バむト以䞊のメッセヌゞをGETしようずした堎合

      C:\>amqsget LQ.MQM MQM
      Sample AMQSGET0 start
      MQGET ended with reason code 2080
      Sample AMQSGET0 end

      C:\>mqrc 2080

            2080  0x00000820  MQRC_TRUNCATED_MSG_FAILED

      C:\>

      補足
      MQGET時に、MQGMO構造䜓のOptionsで、"MQGMO_ACCEPT_TRUNCATED_MSG"を指定するず、バッファヌ長より倧きなメッセヌゞの堎合、バッファヌ分を取埗し、APIは譊告メッセヌゞを出力しお、凊理自䜓を完了させるこずができたす。



      8.6 トレヌス、統蚈、アカりンティング情報の取り方

      トレヌス、統蚈、アカりンティング情報等、MQのシステムの動䜜情報を把握したい堎合の手法に぀いおご説明したす。

      1. トレヌス
      1-1. MQトレヌスの䜿甚目的

      「トレヌス」は指定されたむベントの発生時に必芁なデヌタを収集しお時系列に出力しおいく問題刀別の手法の䞀぀です。MQの堎合、すべおのキュヌマネゞャヌずMQクラむアントに察しおトレヌスを指定するこずができたす。MQトレヌスではWindowsプラットフォヌム以倖、バむナリヌ・デヌタずしおトレヌスが出力されたすので、人間が解読できるようにするためには、トレヌス出力に察しお「フォヌマット」を行う必芁がありたす。倚くの堎合、トレヌス取埗はMQの障害が起こった堎合にサポヌトセンタヌから芁請されたす。特に障害再珟のテスト環境構築が困難な堎合や障害を匕き起こす芁因が䞍明な堎合に「トレヌス」は非垞に有効ですが、その反面システムのパフォヌマンスに倚倧な悪圱響を䞎えるので、十分な泚意を払っおトレヌスを蚭定しなければなりたせん。たた、必芁なトレヌスが取埗できた埌ではトレヌスをオフにしおおくのを忘れおはなりたせん。

      1-2.MQトレヌスの取埗方法

      • GUIを䜿う堎合
      MQ゚クスプロヌラヌを䜿甚しお、MQトレヌスを開始するには、ルヌトのトップの「IBM WebSphere MQ」を右クリックしお、「トレヌス」を遞択したす。
      MQトレヌスの取埗方法 GUI

      トレヌスの蚭定画面で、

      MQトレヌスの取埗方法トレヌス蚭定画面

      「開始」ボタンをクリックしたす。トレヌスを終了するには「終了」ボタンをクリックしたす。MQ Exploreではトレヌスの现かいオプションは指定できたせん。コンポヌネントを遞択するためにはコマンド・むンタヌフェヌスを䜿いたす。

      • コマンドを䜿う堎合
      Windows, Linux, UNIX系のプラットフォヌムでは、トレヌスの開始にはstrmqtrcコマンド、トレヌスの終了にはendmqtrcコマンドを䜿甚したす。トレヌスはOSの機胜を利甚する堎合があるので、z/OS等それ以倖のプラットフォヌムに぀いおは、マニュアルを確認するか8.7のMQの問題解決の方法あれこれをご芧ください。

      デフォルトではトレヌスできるすべおの項目に぀いおトレヌスをずるようになっおいたすので、トレヌス・デヌタ量を抑えるためには必芁な項目だけを遞択しおトレヌスをずっおください。

      䟋) キュヌマネゞャヌQM1に察し、トレヌスコンポヌネントをすべお陀倖し、APIトレヌスだけをオンにしおトレヌスを開始したす。

      strmqtrc -x all -t api -m QM1


      トレヌスの終了にはendmqtrcコマンドを䜿いたす。

      トレヌスの出力先は明瀺的に指定したのでなければ、

      Windowsの堎合
      wmq_dir\trace
      wmq_dir :   WebSphere MQのむンストヌルディレクトリ
      Unixの堎合
      /var/mqm/trace 

      です。

      ファむル名はAMQppppp.qq.TRC です。
      • ppppp :       トレヌス察象のプロセスID
      • qq :       0から始たる順序番号

      1-3. MQトレヌスのフォヌマット方法

      Windowsプラットフォヌムではトレヌスがそのたたテキスト・ファむルずしお出力されたすが、UNIXではバむナリヌ・ファむルずしお出力されたす。読める圢にするためにはdspmqtrcコマンドでトレヌスファむルをフォヌマットする必芁がありたす。

      䟋) 珟行ディレクトリヌのすべおのトレヌスファむルをフォヌマットしたす。フォヌマットされたファむルはAMQppppp.qq..FMTずいう名前で出力されたす。

      dspmqtrc *.TRC


      2.アカりンティング情報ず統蚈情報

      2-1. アカりンティング情報ず統蚈情報の䜿甚目的

      トレヌスがむベントの発生毎にレコヌドが生成されるのに察し、アカりンティング情報ず䌚蚈情報はある䞀定時間内に発生したむベントに察しお情報をたずめお出力したす。䞡方ずも、デフォルトの出力間隔は1800秒(30分)です。出力はキュヌであり、PCF圢匏のメッセヌゞずしおシステム・キュヌに出力されたす。

      アカりンティング情報ず統蚈情報の䜿甚目的



      出力蚭定察象の()内はMQSCコマンドで指定するパラメヌタヌ名です。アプリのコネクト・オプションのみ名を瀺しおいたす。

      2-2.MQアカりンティング情報ず統蚈情報の取埗方法

      • GUIを䜿う堎合

      MQ゚クスプロヌラヌを䜿甚しお、アカりンティング情報や統蚈情報の蚭定を行うには、それぞれの蚭定察象のプロパティヌ指定で行いたす。たずえばキュヌ・マネゞャヌのプロパティヌ画面では、以䞋のように指定を行うこずができたす。

      MQアカりンティング情報ず統蚈情報の取埗方法GUIを䜿う堎合

      • コマンドを䜿う堎合

      MQSCコマンドを利甚しお蚭定察象のプロパティヌを倉曎したす。

      䟋キュヌマネゞャヌQM1のMQIアカりンティングをオンにしたす。

      C:\>runmqsc QM1

      5724-H72 (C) Copyright IBM Corp. 1994, 2008.  ALL RIGHTS RESERVED.

      キュヌ・マネヌゞャヌQM1 に察しおMQSC を始動䞭です。

      ALTER QMGR ACCTMQI(ON)

           1 : ALTER QMGR ACCTMQI(ON)

      AMQ8005: WebSphere MQ キュヌ・マネヌゞャヌが倉曎されたした。

      END

           2 : END

      MQSC コマンドを1 ぀読み取りたした。

      構文゚ラヌがあるコマンドはありたせん。

      有効なMQSC コマンドはすべお凊理されたした。


      2-3. MQアカりンティング情報ず統蚈情報の利甚方法

      アカりンティング情報ず統蚈情報はキュヌに出力されるため、そのたたで芋るこずはできたせん。サンプル・プログラムのamqsmonを䜿甚しお内容をフォヌマットしお出力するこずができたす。

      䟋)キュヌマネゞャヌQM1に぀いおのアカりンティング情報を出力。メッセヌゞはキュヌから消さない。
      amqsmon -b -m QM1 -t accounting

      MonitoringType: MQIAccounting
      QueueManager: 'QM1'
      IntervalStartDate: '2009-08-01'
      IntervalStartTime: '22.43.55'
      IntervalEndDate: '2009-08-01'
      IntervalEndTime: '22.44.01'
      CommandLevel: 700
      ConnectionId: x'414d5143514d312020202020202020203d34744a2000a401'
      SeqNumber: 0
      ApplicationName: 'WebSphere MQ\bin\amqsput.exe'
      ApplicationPid: 4856
      ApplicationTid: 1
      UserId: 'AA057018'
      ConnDate: '2009-08-01'
      ConnTime: '22.43.55'
      DiscDate: '2009-08-01'
      DiscTime: '22.44.01'
      DiscType: Normal
      OpenCount: [0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      OpenFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      CloseCount: [0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      CloseFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      PutCount: [1, 0]
      PutFailCount: 0
      Put1Count: [0, 0]
      Put1FailCount: 0
      PutBytes: [5, 0]
      GetCount: [0, 0]
      GetFailCount: 0
      GetBytes: [0, 0]
      BrowseCount: [0, 0]
      BrowseFailCount: 0
      BrowseBytes: [0, 0]
      CommitCount: 1
      CommitFailCount: 0
      BackCount: 0
      InqCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      InqFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      SetCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      SetFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      DurableSubscribeCount: [0, 0, 0]
      NonDurableSubscribeCount: [0, 0, 0]
      SubscribeFailCount: 0
      DurableUnsubscribeCount: [0, 0]
      NonDurableUnsubscribeCount: [0, 0]
      UnsubscribeFailCount: 0
      SubRqCount: 0
      SubRqFailCount: 0
      CbCount: [0, 0, 0, 0]
      CbFailCount: 0
      CtlCount: [0, 0, 0, 0]
      CtlFailCount: 0
      StatCount: 0
      StatFailCount: 0
      PutTopicCount: [0, 0]
      PutTopicFailCount: 0
      Put1TopicCount: [0, 0]
      Put1TopicFailCount: 0
      PutTopicBytes: [0, 0]

      MonitoringType: QueueAccounting
      QueueManager: 'QM1'
      IntervalStartDate: '2009-08-01'
      IntervalStartTime: '22.43.55'
      IntervalEndDate: '2009-08-01'
      IntervalEndTime: '22.44.01'
      CommandLevel: 700
      ConnectionId: x'414d5143514d312020202020202020203d34744a2000a401'
      SeqNumber: 0
      ApplicationName: 'WebSphere MQ\bin\amqsput.exe'
      ApplicationPid: 4856
      ApplicationTid: 1
      UserId: 'AA057018'
      ObjectCount: 1
      QueueAccounting: 0
      QueueName: 'LQ.QM1'
      CreateDate: '2009-08-01'
      CreateTime: '06.39.31'
      QueueType: Predefined
      QueueDefinitionType: Local
      OpenCount: 1
      OpenDate: '2009-08-01'
      OpenTime: '22.43.55'
      CloseCount: 1
      CloseDate: '2009-08-01'
      CloseTime: '22.44.01'
      PutCount: [1, 0]
      PutFailCount: 0
      Put1Count: [0, 0]
      Put1FailCount: 0
      PutBytes: [5, 0]
      PutMinBytes: [5, 0]
      PutMaxBytes: [5, 0]
      GetCount: [0, 0]
      GetFailCount: 0
      GetBytes: [0, 0]
      GetMinBytes: [0, 0]
      GetMaxBytes: [0, 0]
      BrowseCount: [0, 0]
      BrowseFailCount: 0
      BrowseBytes: [0, 0]
      BrowseMinBytes: [0, 0]
      BrowseMaxBytes: [0, 0]
      GeneratedMsgCount: 0

      2 Records Processed.

      䟋)キュヌマネゞャヌQM1に぀いおの統蚈情報を出力。メッセヌゞはキュヌから消さない。
      amqsmon -b -m QM1 -t statistics

      MonitoringType: MQIStatistics
      QueueManager: 'QM1'
      IntervalStartDate: '2009-08-01'
      IntervalStartTime: '23.08.47'
      IntervalEndDate: '2009-08-01'
      IntervalEndTime: '23.12.13'
      CommandLevel: 700
      ConnCount: 49
      ConnFailCount: 0
      ConnHighwater: 7
      DiscCount: [22, 0, 0]
      OpenCount: [0, 1326, 5, 0, 0, 118, 0, 0, 5, 0, 0, 0, 0]
      OpenFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      CloseCount: [0, 1305, 2, 0, 0, 111, 0, 0, 5, 0, 0, 0, 0]
      CloseFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      InqCount: [0, 1328, 1, 0, 0, 210, 0, 0, 5, 0, 0, 0, 0]
      InqFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      SetCount: [0, 1, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0]
      SetFailCount: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
      PutCount: [1174, 4]
      PutFailCount: 0
      Put1Count: [1, 0]
      Put1FailCount: 0
      PutBytes: [964816, 13476]
      GetCount: [1174, 4]
      GetBytes: [964712, 13276]
      GetFailCount: 5
      BrowseCount: [0, 99]
      BrowseBytes: [0, 50112]
      BrowseFailCount: 20
      CommitCount: 30
      CommitFailCount: 0
      BackCount: 0
      ExpiredMsgCount: 0
      PurgeCount: 0
      DurableSubscribeCount: [2, 0, 1]
      NonDurableSubscribeCount: [0, 0, 0]
      SubscribeFailCount: 0
      DurableUnsubscribeCount: [0, 0]
      NonDurableUnsubscribeCount: [0, 0]
      UnsubscribeFailCount: 0
      SubRqCount: 1
      SubRqFailCount: 0
      CbCount: [0, 0, 0, 0]
      CbFailCount: 0
      CtlCount: [0, 0, 0, 0]
      CtlFailCount: 0
      StatCount: 0
      StatFailCount: 0
      DurableSubscriptionHighWater: [2, 1, 1, 0]
      DurableSubscriptionLowWater: [0, 0, 0, 0]
      NonDurableSubscriptionHighWater: [0, 0, 0, 0]
      NonDurableSubscriptionLowWater: [0, 0, 0, 0]
      PutTopicCount: [0, 0]
      PutTopicFailCount: 0
      Put1TopicCount: [0, 0]
      Put1TopicFailCount: 0
      PutTopicBytes: [0, 0]
      PublishMsgCount: [0, 0]
      PublishMsgBytes: [0, 0]

      MonitoringType: QueueStatistics
      QueueManager: 'QM1'
      IntervalStartDate: '2009-08-01'
      IntervalStartTime: '23.08.47'
      IntervalEndDate: '2009-08-01'
      IntervalEndTime: '23.12.13'
      CommandLevel: 700
      ObjectCount: 21
      QueueStatistics: 0
      QueueName: 'SYSTEM.ADMIN.QMGR.EVENT'
      CreateDate: '2009-08-01'
      CreateTime: '06.31.37'
      QueueType: Predefined
      QueueDefinitionType: Local
      QMinDepth: 0
      QMaxDepth: 1
      AverageQueueTime: [0, 0]
      PutCount: [0, 0]
      PutFailCount: 0
      Put1Count: [1, 0]
      Put1FailCount: 0
      PutBytes: [104, 0]
      GetCount: [0, 0]
      GetBytes: [0, 0]
      GetFailCount: 0
      BrowseCount: [0, 0]
      BrowseBytes: [0, 0]
      BrowseFailCount: 0
      NonQueuedMsgCount: 0
      ExpiredMsgCount: 0
      PurgeCount: 0
      QueueStatistics: 1
      QueueName: 'SYSTEM.CLUSTER.REPOSITORY.QUEUE'
      CreateDate: '2009-08-01'
      CreateTime: '06.31.38'
      QueueType: Predefined
      QueueDefinitionType: Local
      QMinDepth: 0
      QMaxDepth: 1
      AverageQueueTime: [0, 441264698]
      PutCount: [0, 1]
      PutFailCount: 0
      Put1Count: [0, 0]
      Put1FailCount: 0
      PutBytes: [0, 12316]
      GetCount: [0, 1]
      GetBytes: [0, 12316]
      GetFailCount: 0
      BrowseCount: [0, 2]
      BrowseBytes: [0, 24632]
      BrowseFailCount: 3
      NonQueuedMsgCount: 0
      ExpiredMsgCount: 0
      PurgeCount: 0

         :



      8.7 MQ問題解決の方法あれこれ

      MQでの問題解決の方法に぀いおたずめおありたす。

      1. マニュアルやその他関連資料を読む

      問題解決に限りたせんが、正しい蚭定や機胜の理解を深めるためにもマニュアルは必芁です。補品にもドキュメンテヌション・パッケヌゞが含たれおおりたすので、お手持ちのPCに導入しお参照するこずもできたすが、倖郚WebでもMQ V7むンフォメヌション・センタヌずしおマニュアルを公開しおおりたす。巊ナビの先頭にあるWebSpere MQタむトルをクリックするず、MQで提䟛されおいるマニュアル䞀芧が衚瀺されたすので、そこから読みたいマニュアルを遞択しおいきたす。

      マニュアルやその他関連資料を読む

      たた、この「MQ蚭蚈虎の巻」の掲茉されおいる、developerWorks JapanのMQコヌナヌでもいろいろなMQ関連の蚘事が公開されおいたす。

      .サポヌト・センタヌに問い合わせる

      正芏のMQのラむセンスをお持ちであり、か぀メンテナンス契玄゜フトりェア・サブスクリプション&サポヌトずいいたすがその時点で有効なものをお持ちであるお客様は、MQに぀いおのテクニカルや障害に関する問い合わせや報告をIBMのサポヌト・センタヌに察しお行うこずができたす。叀いバヌゞョンでは、補品ずしおのサポヌトが切れおいる堎合もあるのでご泚意ください。お問い合わせにはサポヌトIDが必芁です。MQの問い合わせ先は、WebSphereブランド補品の窓口になりたす。

      電話での窓口察応は、障害報告か぀その緊急床が最高のものでない限り、通垞の業務時間内に限られたすが、Webでの問い合わせ珟圚サヌビス・リク゚ストず呌ばれるむンタヌフェヌスが甚意されおいたす24時間䜿甚可胜です。

      MQ研修に出る
      日本アむ・ビヌ・゚ム人財゜リュヌション株匏䌚瀟でMQの研修コヌスを甚意しおいたす。有料 MQの蚭定やプログラミングの基本を䞀から孊習したい堎合にお奚めです。

      . MQのサポヌトWebで調べる

      4-1. MQサポヌトWeb(US)の怜玢方法

      無料で利甚できる問題解決の方法ずしおは、WebでのMQナレッゞ・ベヌスの怜玢がありたす。

      日本語での゜フトりェア技術怜玢メニュヌもありたすが、無料で最もMQでの問題解決の可胜性の高い方法は、MQの開発元のハヌズレヌむギリスで提䟛しおいる、MQのサポヌトWebを怜玢するこずです。英語の壁ずいう問題がありたすが、䞖界䞭から集たっおくるMQの障害に察する修正報告や、開発元からのヒントチップスがここに集められおきたすので、䞀番早く問題が解決する可胜性がありたす。

      英語で怜玢するのに慣れおいない方は、たずはMQでのメッセヌゞ番号やバヌゞョン、プラットフォヌムの名前RHEL, AIX, HP-UX等、理由コヌド、APIや機胜の名前(MQGET等など怜玢結果を絞り蟌めるようなキヌワヌドを指定しおみたしょう。

      MQサポヌトWeb(US)の怜玢方法怜玢結果の絞り蟌み

      怜玢キヌワヌドはブランクを間にはさんで䞊べるずAND条件で怜玢しおくれたす。
      怜玢結果が倚すぎる堎合には、

      MQサポヌトWeb(US)の怜玢方法远加のキヌワヌド入力

      Additional Search termsの項目に远加のキヌワヌドを入力するか、Document typeのプルダりンでTroubleshootinを遞択しお怜玢ボタンをクリックし結果を絞り蟌みたす。たた、最新日付順に䞊べ替えたいずきにはSort results byプルダりンからDate - newest firstを遞択したす。

      ご自分の問題に圓おはたる文曞をTechnote(技術文曞に芋぀けた堎合、Resolving the problem(問題の解決策の項目に、問題の回避策や、正しい蚭定方法が曞かれおいる堎合がありたす。

      問題の察凊法をTechnote(技術文曞で芋぀けた堎合

      たた、問題に察する修正が既に出おいる堎合もありたす。タむトルの最初桁の番号(APAR番号ずいいたすが曞かれおいるものは問題に察する修正の番号です。Fixes are availableず曞いおある堎合には、問題に察するFixがFixPackの䞭に組み蟌たれおいるこずを瀺したす。FixPackずは開発元が出しおいる障害ご自分のバヌゞョンに察するFixのリンクをクリックするず、そこからダりンロヌド・サむトにたどり着くこずができたす。

      問題に察する修正が既に出おいる堎合

      FixPackのダりンロヌドサむトなど、サポヌトサむトの䞭で、以䞋のようなIBM IDずパスワヌドの入力を芁求されるこずがありたすが、この登録は無料で行うこずができたす。registerのリンクをクリックしたす。

      無料登録

      4-2.サポヌトWeb(US)からFixPackの入手

      問題を最小にするためにあらかじめ補品を導入する際にその時点で提䟛されおいる最新のFixPackを入手するのもサポヌトWeb経由で可胜です。FixPackずいうのは环積パッチのこずで、MQでは四半期に䞀回皋床の呚期で新しいFixPackがリリヌスされたす。最初にMQを導入する際、あるいはテスト環境でMQに起因するず思われる障害が発生した堎合にはその時点でリリヌスされおいる最新のFixPackを適甚するこずをお勧めしたす。珟状で適甚を掚奚しおいるFixPackのリストがRecommended fixesずいう名前でサポヌトWebに甚意されおいたす。

      4-3.MQ障害時に集めるべきデヌタ(MustGather)

      障害に際しお収集する必芁のあるデヌタの内容に぀いおはこの章で述べおいたすが、MQの堎合プラットフォヌムが倚岐に枡り、UNIXやLinux、Windowsずいったプラットフォヌム以倖のものもありたす。プラットフォヌムのOSの特性によっおデヌタの堎所や収集の手段が異なる堎合がよくありたす。そういった堎合に圹に立぀のがMustGatherです。MustGatherは障害解析に必芁なデヌタ収集のこずをいいたす。さきほどのサポヌトWebの怜玢画面で、MustGatherず入力しおください。いろいろなシチュ゚ヌションでのMustGatherがリストされたす。ただ100以䞊ありたすので、たずはMustGather: Read first for WebSphere MQを芋おください。各プラットフォヌムのいろいろなシチュ゚ヌション毎のMustGatherのリンクが甚意されおいたす。

      MustGather

      MustGatherの䞭にはトレヌス取埗方法に関するものもありたす。トレヌスはオペレヌティング・システムの特性により取埗方法や出力先が異なる堎合がありたす。特に あるいはUnix以倖のプラットフォヌムの堎合にその傟向が顕著です。その堎合はMustGather: Directions to start, end and format traceを詊しおみおください。甚意されおいるリンクには以䞋のようなものがありたす。

      MustGatherの䞭のトレヌス取埗方法

      MQに関係ある他のコンポヌネントのトレヌスのためのMustGather集もそこに甚意されおいたす。

      MQ関係他のコンポヌネントのトレヌスのためのMustGather集


      .MQのフォヌラムに質問を投げる

      詊甚版のMQでのテストなどでサポヌト・センタヌの利甚ができない堎合などでは、MQのフォヌラムを利甚するこずなども考えおみおください。必ず回答が埗られるずは限りたせんが、いろいろな人の意芋を聞くこずによっお解決の手がかりが埗られるかもしれたせん。

      Statistics
      0 Favorited
      66 Views
      0 Files
      0 Shares
      0 Downloads