MQ エージェントの設定
内容
apmdevops102jp
内容
MQ Java Connector エージェントの設定
MQ Java コネクタは、WebSphere MQ と通信するさまざまなコネクタ、JMS クラス、およびメソッドを監視します。
以下の手順に従います。
- 拡張機能をインストールして有効にした場合は、以下のように、<AppServer_Home>/wily/core/config ディレクトリにある IntroscopeAgent.profile ファイルの introscope.autoprobe.directivesFile プロパティに PBL ファイルが追加されていることを確認します。introscope.autoprobe.directivesFile=websphere-typical.pbl,hotdeploy,webspheremq.pbl注:この例は、WebSphere MQ pbl が websphere-typical.pbl に追加されている WebSphere Application Server の場合です。
- webspheremq.pbl を開き、さらなるインスツルメンテーションのために追加が必要なすべての pbd のコメント化を解除します。たとえば webspheremq_errors.pbd などです。
- MQMonitor エージェントによってレポートされるメトリックの送信先の Enterprise Manager の接続プロパティを指定します。IntroscopeAgent.profile ファイルを使用して、以下のプロパティを設定します。
- agentManager.url.1Enterprise Manager のホスト名または IP アドレスと Enterprise Manager ポートを指定します。デフォルト:localhost:5001
注:
メトリック エイジング プロパティの詳細については、「CA APM Java エージェント実装」ページを参照してください。WebSphere MQ キュー マネージャを監視する MQMonitor の設定
MQMonitor エージェントは、キュー マネージャ、キュー、チャネルなどの WebSphere MQ リソース、およびブローカ、メッセージ フローなどの WebSphere MB リソースに関連する情報を提供します。この機能では、アラートをトリガし、コンポーネントの使用率の測定を表示し、リソース プロパティを表示するために、さまざまな動的な WebSphere MQ または WebSphere MB プロパティを監視できます。
注:
MQMonitor エージェントは、Windows または UNIX でのみサポートされています。MQMonitor エージェントを設定するには、以下の手順に従います。
サードパーティ ライブラリ用の MQMonitor エージェントの設定
MQMonitor エージェントを実行するには、MQMonitor エージェント ホスト上のサードパーティ JAR ファイルの場所で起動スクリプトを編集します。ファイルの実際のパスでクラスパスを変更するために、起動スクリプト startMQMonitor.bat (Windows)または startMQMonitor.sh (UNIX)を編集します。
注
: MQ 8.0 には connector.jar が含まれていません。IIB 10 (MB)または MQ 7.5 から、connector.jar をコピーすることができます。WebSphere MQ 6.0 を監視する方法
com.ibm.mq.jar
- connector.jar
WebSphere MQ 7.0、7.1、および 7.5 を監視する方法
com.ibm.mq.jar
- connector.jar
- com.ibm.mq.commonservices.jar
- com.ibm.mq.headers.jar
- com.ibm.mq.jmqi.jar
- WebSphere MQ 7.x のインストール パス <WebSphere MQ 7.x ホーム>/java/lib から取得された com.ibm.mq.pcf.jar。
注:
WebSphere MQ v7.x キュー マネージャを監視するには、言及した 2 つの PCF JAR ファイルが必要です。MQMonitor エージェント起動スクリプトでこの 2 つの JAR ファイルへのパスを指定します。WebSphere MB 6.0 ~ 6.1 または MB 7.0 を監視する方法
com.ibm.mq.jar
MQMonitor エージェントのプロパティの設定
/MQMonitor/properties ディレクトリ内の MQMonitor.properties ファイルを見つけ、要件に合わせてプロパティを設定します。
以下の手順に従います。
- 監視するキュー マネージャをすべて一覧表示します。mq.monitor.list=<QM1@hostname>,<QM2@hostname>,<QM3@hostname>
- 一覧表示されたすべてのキュー マネージャに関する以下の情報を提供します。<QM1@host>.host <QM1@port>.port以上で、MQMonitor.properties ファイルが設定されました。
注:
監視する対象に応じて、MQMonitor.properties ファイル内の他のプロパティを設定します。たとえば、MQMonitor.properties ファイルを編集して、MQ イベントを監視するキューを識別します。アプリケーション定義モデル キューによる監視
デフォルトのシステム モデル キュー(SYSTEM.DEFAULT.MODEL.QUEUE)ではなく、カスタム定義モデル キューを使用して、キュー マネージャを監視できます。
以下の手順に従います。
- キュー マネージャで、カスタム モデル キューを定義します。
- MQMonitor.properties ファイルを更新します。
- /MQMonitor properties ディレクトリにある MQMonitor.properties ファイルを開きます。
- 「<Queue Manager>_<Host>.modelqueue property=ModelQueueName」のコメント化を解除します。
- ModelQueueName をカスタム モデル キュー名に置き換えます。
- MQ Monitor がカスタム モデル キューにアクセスするための適切な権限が設定されていることを確認します。
- MQ Monitor を再起動し、MQ Monitor がキュー マネージャに接続できることを確認します。
MQMonitor エージェントの実行
MQMonitor エージェントの設定を完了するには、それを実行します。
以下の手順に従います。
- JAVA_HOME 変数がシステム プロパティで設定されていることを確認します。
- /MQMonitor ディレクトリで、startMQMonitor.bat (Windows)または startMQMonitor.sh (UNIX)ファイルを実行します。WebSphere MQ ツリー、WebSphere MB ツリー、またはその両方が、Workstation ツリーの WebSphere MQ および Message Broker Agent ノード下に表示されます。
WebSphere メッセージ ブローカを監視する MQMonitor の設定
メッセージ ブローカを監視し、メッセージ ブローカのブローカ統計およびメッセージ フロー統計を取得するように、CA APM for IBM WebSphere MQ を設定します。
WebSphere MB 6.x 用の MBMonitor.properties ファイルの設定
MB 6.x を監視するように CA APM for IBM WebSphere MQ を設定できます。
以下の手順に従います。
- /MQMonitor/properties ディレクトリに移動し、テキスト エディタで MBMonitor.properties ファイルを開きます。
- 以下のプロパティを設定します。
- configuration.manager.hostConfiguration Manager Proxy (CMP)のマシン名または IP アドレスを指定します。例:configuration.manager.host=localhost
- configuration.manager.queue.managerCMP キュー マネージャ名を指定します。例:configuration.manager.queue.manager=WBRK6_DEFAULT_QUEUE_MANAGER
- configuration.manager.portCMP キュー マネージャ ポートを指定します。例:configuration.manager.port=2414
注:
監視する対象に応じて、MBMonitor.properties ファイル内の他のプロパティを設定します。重要:
WebSphere MB 6.0 ~ 6.1 用の MBMonitor.properties ファイルを設定した場合、WebSphere MB 7.0 または MB 8.0 のメッセージ ブローカを監視するように CA APM for IBM WebSphere MQ を設定することはできません。両方の設定ファイルを有効にすると、WebSphere MB 監視が失敗します。WebSphere MB 7.0 または 8.0 用の MBMonitor_7.properties ファイルの設定
MB 7.0 および 8.0 を監視するように、CA APM for IBM WebSphere MQ を設定できます。
以下の手順に従います。
- /MQMonitor/properties ディレクトリに移動し、テキスト エディタで MBMonitor_7.properties ファイルを開きます。
- 監視する各ブローカの一意の識別子のカンマ区切りリストを指定します。ブローカ監視を開始するように、このプロパティを設定します。例:mq.broker.monitor.list=a,b
- 一覧表示される各ブローカに対して、以下のプロパティを指定します。
- a.hostブローカ マシン名または IP アドレスを指定します。
- a.queue.managerブローカ キュー マネージャ名を指定します。
- a.portブローカ キュー マネージャ ポートを指定します。
注:
監視する対象に応じて、MBMonitor_7.properties ファイル内の他のプロパティを設定します。JMS キューの作成
MBMonitor.properties ファイルまたは MBMonitor_7.properties ファイルを設定した後に、JMS プロトコルを使用する JMS のキューを作成します。
以下の手順に従います。
- JMS キューを定義する必要があるキュー マネージャを識別します。
- 構成マネージャがブローカのいずれかとキュー マネージャを共有している場合、このキュー マネージャが構成マネージャのキュー マネージャです。
- キュー マネージャが構成マネージャとブローカの間で共有されていない場合、発行/サブスクライブコレクティブ内のいずれかのブローカで JMS キューを作成できます。
- /MQMonitor/properties ディレクトリで、ファイル MBMonitorJMSQueues.mqsc を検索します。このファイルには一連の MQSC コマンドが含まれています。
- queueMgr_name が前の手順で識別したキュー マネージャ名であるメッセージ ブローカ ホストで、以下のコマンドを実行します。runmqsc queueMgr_name < MBMonitorJMSQueues.mqscMBMonitorJMSQueues.mqsc ファイル内のすべてのコマンドが実行されます。
MQ オブジェクトを監視するためのセキュリティ要件の設定
リモート コンピュータから MQ オブジェクトを監視するには、以下の MQ 権限が必要です。ユーザは mqm グループに属している必要はありません。
注:
<QMName> はキュー マネージャで、<GroupName> はユーザ グループ名です。setmqaut -m <QMName> -t qmgr -g <GroupName> +connect +dsp +inq setmqaut -m <QMName> -n SYSTEM.DEFAULT.MODEL.QUEUE -t q -g <GroupName> +get +browse +dsp setmqaut -m <QMName> -n SYSTEM.ADMIN.COMMAND.QUEUE -t q -g <GroupName> +browse +put +dsp +inq setmqaut -m <QMName> -n SYSTEM.ADMIN.PERFM.EVENT -t q -g <GroupName> +get +browse +dsp +inq setmqaut -m <QMName> -n SYSTEM.ADMIN.QMGR.EVENT -t q -g <GroupName> +get +browse +dsp +inq setmqaut -m <QMName> -n SYSTEM.ADMIN.CHANNEL.EVENT -t q -g <GroupName> +get +browse +dsp +inq setmqaut -m <QMName> -n SYSTEM.ADMIN.ACTIVITY.QUEUE -t q -g <GroupName> +get +inq +dsp setmqaut -m <QMName> -n SYSTEM.DEAD.LETTER.QUEUE -t q -g <GroupName> +get +inq +dsp +browse setmqaut -m <QMName> -n ** -t channel -g <GroupName> +dsp setmqaut -m <QMName> -n ** -t q -g <GroupName> +dsp +chg setmqaut -m <QMName> -n ** -t namelist -g <GroupName> +dsp setmqaut -m <QMName> -n ** -t clntconn -g <GroupName> +dsp
MB 6.x のセキュリティ要件の設定
CMP、JMS、PCF 接続用の MQMonitor エージェントには最小限のセキュリティ設定があります。
MQMonitor エージェントの CMP 接続に必要な最小限のセキュリティを設定する方法
- 構成マネージャのキュー マネージャに対する allmqi 権限を以下のように適用します。setmqaut -m <QMGR> -t qmgr -p <user>@<domain> +allmqi注:allmqi 権限は、CMP キュー マネージャに対する inq、set、connect、altusr、setid、setall 権限を設定します。
- CMP キュー マネージャの SYSTEM.BROKER.CONFIG.QUEUE キューに対する put 権限を以下のように適用します。setmqaut -m <QMGR> -t q -n SYSTEM.BROKER.CONFIG.QUEUE -p <user>@<domain> +put
- CMP キュー マネージャの SYSTEM.BROKER.CONFIG.REPLY キューに対する get 権限を以下のように適用します。setmqaut -m <QMGR> -t q -n SYSTEM.BROKER.CONFIG.REPLY -p <user>@<domain> +get
- 以下のコマンドを使用して、構成マネージャで ACL エントリを作成します。mqsicreateaclentry <ConfMgrName> -u <UserName> -m <machineName>/<DomainName> -x V -p以下の例では、machine_y 上の user_x に構成マネージャ ConfigMgr への接続を許可します。mqsicreateaclentry ConfigMgr -u user_x - m machine_y -x V -p
- コマンド コンポーネント:-x V説明:ユーザに構成マネージャ上の表示権限を与えます。
- コマンド コンポーネント:-p説明:「すべてのリソース」アクセス制御エントリとも呼ばれる CMP (Configuration Manager Proxy) へのアクセス権限を追加します。注:キュー マネージャを再起動するか、または runmqsc コマンドを使用して「セキュリティのリフレッシュ」を実行してください。次に、セキュリティ設定を適用した後に構成マネージャを再起動してください。
MQMonitor エージェントの JMS 接続に必要な最小限のセキュリティを設定する方法
- JMS キュー マネージャに対する allmqi 権限を適用します。
- JMS キュー マネージャで定義されたすべての JMS 発行/サブスクライブ キュー(#10)に allmqi 権限を適用します。注:キュー マネージャを再起動するか、または前のセクションで説明されているようにセキュリティ設定を適用した後に runmqsc コマンドを使用して「セキュリティのリフレッシュ」を実行してください。
リモートの WebSphere MB 7.0 または 8.0 を監視するためのセキュリティ要件の設定
WebSphere MB 7.0 または 8.0 をレポートするように環境を設定する場合は、以下の最小限のセキュリティ要件を設定します。
以下の手順に従います。
- ブローカのキュー マネージャで以下のコマンドを実行します。setmqaut -m <QMGR NAME> -t qmgr -p <userid> +all
- 以下の Queues の allmqi 権限を、Broker キュー マネージャの一部として設定します。
- SYSTEM.BROKER.ADMIN.QUEUE
- SYSTEM.BROKER.ADMIN.REPLYTODM
- SYSTEM.BROKER.ADMIN.STREAM
- SYSTEM.BROKER.CONTROL.QUEUE
- SYSTEM.BROKER.DEPLOY.REPLY
- SYSTEM.BROKER.DEPLOY.QUEUE
- SYSTEM.BROKER.DEPLOY.QUEUE
- SYSTEM.BROKER.DEFAULT.STREAM
- SYSTEM.ADMIN.COMMAND.QUEUE
- SYSTEM.ADMIN.PERFM.EVENT
- SYSTEM.ADMIN.QMGR.EVENT
- SYSTEM.ADMIN.CHANNEL.EVENT
- SYSTEM.ADMIN.ACTIVITY.QUEUE
以下のコマンドを使用します。setmqaut -m <QMGR NAME> -n <QUEUE NAME> -p <userid> +allmqi - インストール中に Broker キュー マネージャに対して定義される、以下の JMS 発行/サブスクライブ キューに、allmqi 権限を設定します。
- SYSTEM.JMS.ADMIN.QUEUE
- SYSTEM.JMS.PS.STATUS.QUEUE
- SYSTEM.JMS.REPORT.QUEUE
- SYSTEM.JMS.MODEL.QUEUE
- SYSTEM.JMS.ND.SUBSCRIBER.QUEUE
- SYSTEM.JMS.ND.CC.SUBSCRIBER.QUEUE
- SYSTEM.JMS.D.SUBSCRIBER.QUEUE
- SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE
- SYSTEM.JMS.ND.SUBSCRIBER.WILY.MBMSGFLOW
- SYSTEM.JMS.ND.SUBSCRIBER.WILY.MBBROKER
以下のコマンドを使用します。runmqsc MB7QMGR < C:/MQMonitor/properties/MBMonitorJMSQueues.mqsc - 以下のコマンドを使用して、Broker キュー マネージャ内の SYSTEM.BROKER.MB.TOPIC に allmqi 権限を設定します。setmqaut -m <QUEUE MANAGER> -n SYSTEM.BROKER.MB.TOPIC -t top -p <userid> +allmqi
- (オプション)ブローカとキュー マネージャを再起動します。
追跡用の WebSphere MQ の設定
mqConfigurationSetup ツールを使用して、追跡用の WebSphere MQ システムを設定できます。追跡用の WebSphere MQ システムは手動で設定することもできます。
自動での追跡の設定
mqConfigurationSetup ツールを使用して、プロセスにまたがるトランザクション追跡の設定を自動化できます。ツールには、mqConfigurationSetup.bat (Windows)または mqConfigurationSetup.sh (UNIX)という名前のバッチ ファイルが含まれています。MQMonitor エージェントの /tools ディレクトリで利用可能です。
以下の手順に従います。
- キュー マネージャを監視するために MQMonitor.properties を設定します。
- mqConfigurationSetup.bat ファイルを編集して、以下の設定を行います。
- JAVA_HOME 変数を有効な JRE に設定します。
- MQ_JAR 変数を com.ibm.mq.jar ファイルの場所に設定します。
- PCF_JAR 変数を com.ibm.mq.pcf-6.1.jar ファイルの場所に設定します。
- J2EE_JAR 変数を j2ee.jar ファイルの場所に設定します。
- mqConfigurationSetup.bat ファイルを実行します。コマンドは以下のとおりです。mqConfigurationSetup.bat [-i on/off] [-p ../properties/]注:対話モードまたは非対話モードのパラメータ-iを設定します。パラメータのデフォルト値は on です。パラメータを on に設定した場合、WebSphere MQ オブジェクトのプロパティを変更する前に、ツールによって確認を求められます。パラメータを off に設定した場合、ツールによってすべてのプロパティが変更され、確認は求められません。MQMonitor.properties ファイルの場所を示すパラメータ-pを設定します。このパラメータのデフォルト値は ../properties/ です。
設定ツールでは、すべての監視対象のキュー マネージャおよびキューについて以下のプロパティを更新します。
- 各キュー マネージャで、[Activity recording]プロパティを[Queue]に設定します。
- これらのキューのいずれもキュー マネージャに存在しない場合、SYSTEM.ADMIN.ACTIVITY.QUEUE、デッド レター キュー(DLQ)、およびハンドシェイク キューを作成します。
- SYSTEM.ADMIN.ACTIVITY.QUEUE、デッド レター キュー、およびハンドシェイク キューを以下のように設定します。
- キューの最大の深度プロパティを設定可能な最大値(999999999)に設定します。
- [Put messages]および[Get messages]プロパティを[Allowed]に設定します。
- [Shareability]プロパティを[Shareable]に設定します。
- [Default Input Open Option]プロパティを[Default Input Open Option]に設定します。
キュー マネージャとキューで変更されたすべてのプロパティに関する情報が含まれるレポートをツールで生成します。ツールによって、MQMonitor エージェントの
/tools
ディレクトリの changehistory.txt という名前のファイルにレポートが保存されます。重要:
変更を適用するには、以下のいずれかの
操作を実行します。- 監視対象のキュー マネージャでアクティブなチャネルをすべて再起動
- 監視対象のキュー マネージャをすべて再起動 (z/OS を除く)
- z/OS では、キュー マネージャの再起動によってキュー マネージャの[Activity Recording]プロパティの値が「Queue」ではなく「Message」に変更される場合があるため、CHINIT のみを再起動します。
手動での追跡の設定
追跡用の WebSphere MQ システムを手動で設定できます。
以下の手順に従います。
- 以下のようにキュー マネージャを設定します。
[Activity recording]プロパティの設定
MQMonitor エージェントが監視する WebSphere MQ 内のすべてのキュー マネージャに対して、[Activity recording]プロパティの値を[Queue]に設定します。この設定で、キュー マネージャによるアクティビティ レポートの生成が可能になります。アクティビティ レポートはすべて同じキュー マネージャの SYSTEM.ADMIN.ACTIVITY.QUEUE で生成されます。
[Activity recording]プロパティの設定および表示には MQSC コマンドを使用します。
[Activity recording]プロパティを設定するには、以下のコマンドを入力します。
runmqsc <Queue Manager Name>
[Activity recording]プロパティの値を表示するには、以下のコマンドを入力します。
display QMGR ACTIVREC
[Activity recording]プロパティの値は、コマンド プロンプト ウィンドウの以下の列に表示されます。
- QMNAME(SOURCE)
- ACTIVREC(MSG)
ACTIVREC プロパティ値を QUEUE に設定するには、以下のコマンドを入力します。
alter QMGR ACTIVREC(QUEUE)
[Activity recording]プロパティを確認するには、以下のコマンドを入力します。
display QMGR ACTIVREC
[Activity recording]プロパティの値は、コマンド プロンプト ウィンドウの以下の 2 列に表示されます。
- QMNAME(SOURCE)
- ACTIVREC(QUEUE)
注:
[Activity recording]プロパティの詳細については、IBM のマニュアルを参照してください。重要:
SYSTEM.ADMIN.ACTIVITY.QUEUE を設定した後には、キュー マネージャ MCA を再起動してください。SYSTEM.ADMIN.ACTIVITY.QUEUE の設定
MQ エクスプローラを使用して、SYSTEM.ADMIN.ACTIVITY.QUEUE を設定できます。
以下の手順に従います。
- MQ エクスプローラで、SYSTEM.ADMIN.ACTIVITY.QUEUE を開きます。
- [SYSTEM.ADMIN.ACTIVITY.QUEUE]を右クリックし、[Properties]をクリックします。[SYSTEM.ADMIN.ACTIVITY.QUEUE]プロパティ ウィンドウが表示されます。
- [Extended]を選択し、[Max queue depth]プロパティを[999999999]に設定します。[Shareability ]を[Shareable]に設定します。[Default Input Open Option]プロパティを[Input Shared]に設定します。
- [General]を選択し、[Put messages]および[Get messages]プロパティを[Allowed]に設定します。SYSTEM.ADMIN.ACTIVITY.QUEUE が設定されました。
または、MQSC コマンドを使用して、SYSTEM.ADMIN.ACTIVITY.QUEUE を設定できます。
以下の手順に従います。
- SYSTEM.ADMIN.ACTIVITY.QUEUE を定義するには(まだ定義されていない場合)、以下のコマンドを入力します。define QLOCAL(SYSTEM.ADMIN.ACTIVITY.QUEUE) USAGE (normal) DESCR('For Introscope Use')
- SYSTEM.ADMIN.ACTIVITY.QUEUE を設定するには、以下のコマンドを入力します。alter QLOCAL (SYSTEM.ADMIN.ACTIVITY.QUEUE) PUT (enabled) GET (enabled) DEFPSIST (no) SHARE DEFSOPT (SHARED) MAXDEPTH (999999999)
- SYSTEM.ADMIN.ACTIVITY.QUEUE を確認するには、以下のコマンドを入力します。display QLOCAL(SYSTEM.ADMIN.ACTIVITY.QUEUE)SYSTEM.ADMIN.ACTIVITY.QUEUE が設定されました。
ハンドシェイク キューの設定
ハンドシェイク
は、MQMonitor エージェントと MQ Java コネクタ エージェント間の通信を参照します。既存のキュー マネージャ上でキュー(ハンドシェイク キュー
)を作成することにより、ハンドシェイクを実行できます。すべてのアプリケーション サーバおよび MQMonitor エージェントからアクセス可能な新しいキュー マネージャ上でもハンドシェイクを実行できます。たとえば、ローカル キュー CA_WILY_HANDSHAKE を定義するには、以下の MQSC コマンドを入力します。
define QLOCAL(CA_WILY_HANDSHAKE) USAGE(NORMAL) PUT(ENABLED) GET(ENABLED) DEFPSIST(NO) SHARE DEFSOPT (SHARED) DESCR('For Introscope Use')
この MQSC コマンドは、Put および Get プロパティが有効化されており、永続的ではなく、共有可能な CA_WILY_HANDSHAKE キューを定義します。
キューを確認するには、以下のコマンドを入力します。
display QLOCAL(CA_WILY_HANDSHAKE)
MCA ユーザ ID の設定
MCA ユーザ ID は、クライアントが誰として接続しているかをサーバに通知します(プログラム実行時)。クライアントはソケットを使用して、接続の受信待機をするサーバに接続します。接続が確立されると、サーバはクライアントの認証を検証します。ユーザが接続時に MCA ユーザ ID を指定しない場合、サーバはクライアント ユーザ ID を使用します。
チャネル定義に MCA ユーザ ID を定義することで、クライアント ユーザ ID の権限を無視できます。
追跡データがデッド レター キューに到着しないように、かつトランザクション追跡が発生するように、MCA ユーザ ID を設定できます。以下の手順では、MCA ユーザ ID を設定する方法について説明します。
注:
これは、さまざまな WebSphere MQ プラットフォームのキュー マネージャから構成される WebSphere MQ インフラストラクチャに適用可能です。キュー マネージャの MQ 追跡は別のタイプから構成できます。Java アプリケーションは、WebSphere MQ インフラストラクチャと通信するために WebSphere MQ、JMS または MQ Java コネクタを使用する場合があります。Java アプリケーションの設定に応じて、以下の手順の
いずれか
を使用して MCA ユーザ ID を設定することができます。Java アプリケーションが WebSphere MQ メッセージのユーザ ID を設定する場合は、以下の手順に従ってユーザを追加します。
- MQMessage 上で Java アプリケーションによって設定されるユーザを特定します。
- すべての WebSphere MQ マシン上でユーザを作成します。
- すべてのプラットフォーム上で、WebSphere MQ のインストールによって作成されたグループにユーザを追加します。
- チャネルを再起動します。
Java アプリケーションが WebSphere MQ Message のユーザ ID を設定しない場合は、以下の手順に従って共通ユーザを追加します。
- すべての WebSphere MQ マシンのための共通ユーザを作成します。
- すべてのプラットフォーム上で、WebSphere MQ のインストールによって作成されたグループに共通ユーザを追加します。
- すべてのキュー マネージャ上のすべてのサーバ接続チャネルで WebSphere MQ エクスプローラを使用し、サーバ接続チャネルの MCA ユーザ ID 属性で共通ユーザを設定します。対応する MQSC コマンドは以下のとおりです。alter channel (<channel name>) CHLTYPE (SVRCONN) MCAUSER(<common user>)
- チャネルを再起動します。
プロセスにまたがるトランザクション追跡のハンドシェイクの設定
プロセスにまたがるトランザクション追跡のハンドシェイク機能を設定します。ハンドシェイクは、MQ Java エージェントと MQMonitor エージェント間の通信に使用される共通のキュー マネージャを必要とします。
- MQAgent.properties ファイルでは、以下のプロパティを設定します。
- mq.crossprocesstracing.enabled = true
- mqmonitor.mqagent.id.list = <MQMonitor ハンドシェイク ID>
- handshake.mqagent.id = <一意の ID>
- handshake.qm.host = <キュー マネージャ ホスト名>
- handshake.qm.port = <ポート番号>
- handshake.queue= <キュー名>
- MQMonitor.properties ファイルでは、以下のハンドシェイク プロパティを設定します。
- handshake.mqagent.id = <一意の ID>
- handshake.qm.host = <キュー マネージャ ホスト名>
- handshake.qm.port = <ポート番号>
- handshake.queue= <キュー名>
プロパティの詳細については、それぞれのプロパティ ファイルを参照してください。
注:
MQMonitor.properties ファイル内の mqmonitor.mqagent.id.list および handshake.mqagent.id は同じ ID になります。handshake.qm.host、handshake.qm.port、および handshake.queue の値は、それらが共通のキュー マネージャを参照するため、すべてのプロパティ ファイルで同じにする必要があります。重要:
プロセスにまたがるトランザクション追跡は、ハンドシェイクなしでも設定できます。MQMonitor.properties ファイルで、ハンドシェイク プロパティを無効にします。また、MQAgent.properties ファイルに、以下のプロパティを設定します。mq.crossprocesstracing.enabled プロパティは true である必要があります
- mqmonitor.mqagent.id.list プロパティはブランクである必要があります
イベントを発行するための WebSphere MQ の設定
WebSphere MQ を設定して、CA Introscope で表示できるイベントを発行できます。
以下の手順に従います。
- MQMonitor.properties ファイルを編集して、MQ イベントを監視するキューを識別します。
- 以下のイベントを MQ サーバ上で設定できます。
- キュー マネージャのイベントについては、権限、禁止、ローカル、リモート、起動、および停止の監視を有効にします。
- チャネル イベントについては、チャネル、SSL、およびチャネルの自動定義の監視を有効にします。
- パフォーマンス イベントについては、パフォーマンスの監視を有効にします。[Queue properties]ダイアログ ボックスで、キュー深度イベントおよびサービス間隔イベントを有効にすることができます。
注:複数のアプリケーションが MQ イベント キューを監視している場合、MQMonitor エージェントはエラーをスローします。デフォルトのプロパティを使用している場合、このエラーを回避するには、キュー プロパティに移動します。キューは SYSTEM.ADMIN.PERFM.EVENT、SYSTEM.ADMIN.QMGR.EVENT、および SYSTEM.ADMIN.CHANNEL.EVENT です。[Extended]タブをクリックします。[Shareability]プロパティを[Shareable]に、[Default Input Open Option]プロパティを[Input shared]に設定します。 - MQMonitor エージェントを開始します。注:MQSC コマンドを使用して MQ イベントの監視を有効化することもできます。詳細については、IBM WebSphere MQ のマニュアルを参照してください。