mqsideploy コマンド

サポートされるプラットフォーム

  • Windows
  • Linux および UNIX システム
  • z/OS

目的

mqsideploy コマンドを使用して、構成マネージャーに対してデプロイメント要求を出します。そのため、手動の対話を必要としないでバッチ・コマンド・スクリプトから多種多様なデプロイメント要求を出すことができます。

デフォルトの状態は、デルタまたは増分デプロイメントです。デフォルトの操作をオーバーライドするには、-m を選択します。

接続に必要な詳細情報はすべて -n-q-i、および -p パラメーターから入手できるので、mqsideploy には構成マネージャー名のパラメーターは必要ありません。

構文

Windows プラットフォーム、Linux、および UNIX システム

z/OS コンソール・コマンド

同義語: dp

パラメーター

-n cfgParameterFileName
(オプション) 構成マネージャーへの接続パラメーターを記述する .configmgr ファイルの名前。
このファイルは、Eclipse GUI で保管される .configmgr 形式をとる XML ファイルです。 以下に例を示します。
<?xml version="1.0" encoding="UTF-8"?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
このファイルを z/OS で使用する場合、ステートメント encoding="UTF-8" を最初の行から除去して、ステートメントを以下のままにする必要があります。
<?xml version="1.0"?>
さらに、ホスト属性の値を除去して、ステートメントを下記のようにする必要もあります。
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
注: このパラメーターを提供しない場合、-i-p、および -q パラメーターを指定する必要があります。
-i ipAddress
(オプション) 構成マネージャーのホスト名または IP アドレス。

このファイルを z/OS で使用し、ローカル・ホストに接続する場合は、値を ¥"¥" に設定する必要があります。

-p Port
(オプション) 構成マネージャーのポート番号。
-q qMgr
(オプション) 構成マネージャーが使用している WebSphere MQ キュー・マネージャーの名前。

-i-p、および -q パラメーターを指定しない場合は、-n パラメーターを指定しなければなりません。

-b Brokername
(必須) デプロイ先のブローカーの名前を指定します。 -t または -l のいずれかのフラグを指定すると、-b オプションは無視されます。その理由は、トピックまたはトポロジーのデプロイを行うと、ドメイン内のすべてのブローカーが影響を受けるからです。-e フラグと -a フラグを付けないと、ブローカー構成のデプロイが開始されます。

-c オプションを指定すると、特定のブローカーに対するデプロイメントはキャンセルされます。

-e EGName
(オプション) デプロイ先の実行グループの名前を指定します。このオプションでは、-b オプションと -a オプションも指定する必要があります。
-aBARFileName
(オプション) メッセージ・フローまたはメッセージ・セットのデプロイに使用される BAR (ブローカー・アーカイブ) ファイルの名前です。このオプションでは、-b オプションと -e オプションも指定する必要があります。

z/OS では、BAR ファイルがファイル・システム内に存在している必要があります。 BAR ファイルの場所は、コマンドを実行しているユーザーまたは構成マネージャーのユーザー ID でファイルにアクセスして読み取ることができれば、どこでも構いません。

-t
(オプション) すべてのトピック構成情報をデプロイします。情報は、ドメイン内のすべてのブローカーに対してデプロイされます。
-l
(オプション) このフラグは、トポロジー構成をデプロイすることを指定します。-m フラグも設定した場合は、情報はドメイン内のすべてのブローカーにデプロイされますが、設定しなかった場合は、情報はトポロジー構成を変更されたブローカーにのみデプロイされます。
-c
(オプション) 構成マネージャーに、停止して以前に実行依頼されたデプロイメント要求に対する応答を待つよう指示します。-b オプションを付けて使用すると、構成マネージャーは、停止して指定されたブローカーからの未解決のデプロイメント応答を待ち、-b オプションを付けないと、構成マネージャーは、停止してドメイン内のすべての未解決のデプロイメント要求に対する応答を待ちます。

-c オプションを指定する際には注意してください。このオプションは、影響を受けるブローカーが今後デプロイメント要求に対して応答する可能性がない場合のみ使用してください。キャンセルされたデプロイメント要求の処理をブローカーが続行すると、構成マネージャーはその応答を無視するので、ブローカーとの同期が取れなくなります。

-w timeoutValue
(オプション) 制御がコマンド行に戻されるまでにユーティリティーがブローカーからの応答を待つ時間を秒数で指定します。mqsideploy コマンドは構成マネージャーのログ・レコードをポーリングして、送信されたばかりのデプロイ要求の結果を探します。それに関連したログ・レコードには、デプロイが正常に完了したかどうかを示す情報が含まれています。 timeoutValue は、タイムアウトまで待機する秒数 (1 から 999 999 の範囲) です。timeoutValue を指定しない場合や、1 より小さい値または 999 999 より大きい値を指定した場合、エラーが戻されます。
-d DeployedObjects
(オプション) 実行グループから除去されるオブジェクトの集合を記述します。複数のデプロイされたファイルを、":" 文字で区切って指定できます。

すべてのタイプのオブジェクトを指定できますが、あいまいなオブジェクト名を指定すると (例えば、「top.dictionary」と「top.cmf」が両方とも同じ実行グループにデプロイされている場合に「top」を指定するなど) 、コマンド全体がメッセージ BIP1089 で失敗するという制限があります。 この場合には、除去するオブジェクトの完全修飾名 (例えば "top.dictionary:top.cmf") を指定しなければなりません。

-v TraceFileName
(オプション) 内部構成マネージャー・プロキシーのデバッグ・トレースを、指定されたファイルに送信します。
-m -complete
(オプション) 情報をすべて完全にデプロイします。
  • bar ファイルのデプロイの場合、-m は、現在デプロイされているすべてのメッセージ・フローとメッセージ・セットをデプロイの一環として実行グループから除去することを示します。-m を設定しないと、実行グループ上にすでにデプロイされているものに加えて、bar ファイルの内容もデプロイされます。その場合、BAR 内の項目と同じ名前を持つデプロイ済みオブジェクトはすべて、BAR 内のバージョンに置き換えられます。
  • トポロジー構成のデプロイの場合、-m は、ブローカー間の完全な構成情報をすべてのブローカーにデプロイします。-m を設定しないと、変更されたブローカー間構成だけが、変更済みのブローカー間構成を持つブローカーに対してデプロイされます。
  • ブローカー構成のデプロイの場合、このフラグは無効です。
  • トピック・ツリーのデプロイ の場合、-m は、トピック・ツリー全体をすべてのブローカーにデプロイします。-m を設定しないと、トピック・ツリーに加えられた変更だけがすべてのブローカーに対してデプロイされます。
  • メッセージ・フローの除去またはメッセージ・セットの除去の操作の場合、このフラグは無視されます。

許可

正常にデプロイするには、コマンドを発行するユーザー ID に、構成マネージャーで定義されている十分な権限が必要です。必要な許可は、Message Brokers Toolkit の同等の機能を実行する場合に必要な許可と同じです。 構成マネージャーで定義できる許可のリストについては、ACL 許可を参照してください。

応答

このコマンドは、以下の応答を戻します。
0
(Success) 構成マネージャーがデプロイメント要求を発行し、タイムアウト期間の期限が切れる前に関係のあるすべてのブローカーが肯定応答したことを示します。
2
(Failure) 構成マネージャーがデプロイメント要求を発行し、1 つ以上のブローカーが否定応答したことを示します。詳しくは、ユーティリティーからのメッセージ出力 (または構成マネージャーのイベント・ログ) を参照してください。
3
(Initiated) 構成マネージャーが返信し、デプロイメントが開始されたことを通知しましたが、タイムアウトになる前にブローカー応答が受信されなかったことを示します。
5
(Submitted) デプロイ・メッセージは構成マネージャーに送信されましたが、タイムアウトになる前に応答が受信されなかったことを示します。
6
(SuccessSoFar) 構成マネージャーがデプロイメント要求を発行し、タイムアウト期間の期限が切れる前にすべてではなく一部のブローカーが肯定応答したことを示します。否定応答したブローカーはありません。
98
構成マネージャーに到達できないことを示します。
99
ユーティリティーに提供された引数が無効であることを示します。

パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用して パブリッシュ/サブスクライブ 近隣をデプロイします。ブローカーが応答するまで 10 分間待ち、それから完全なブローカー間構成情報をデプロイします。
mqsideploy -n cm1.configmgr -m -w 600
構成マネージャー に接続する ip、および q パラメーターを使用して、パブリッシュ/サブスクライブ 近隣をデプロイします。ブローカーが応答するまで 10 分間待ち、それから完全なブローカー間構成情報をデプロイします。
mqsideploy -i localhost -p 1414 -q QMNAME -m -w 600

以下の例では、-n パラメーターの代わりに、ip、および q パラメーターを使用できます。

パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用してトピック階層をデプロイします。ブローカーが応答するまで 10 分間待ち、それから完全なブローカー間構成情報をデプロイします。
mqsideploy -n cm1.configmgr -t -m -w 600
パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用して bar ファイルをデプロイします。ブローカーが応答するまで 10 分間待ち、次に、デプロイの一部としての実行グループから、現在デプロイされているすべてのメッセージ・フローおよびメッセージ・セットを除去します。
mqsideploy -n cm1.configmgr -b broker1 -e default -a mybar.bar -m -w 600
パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用して、ブローカー構成を指定されたブローカーにデプロイします。ブローカーが応答するまで 15 分間待ちます。
mqsideploy -n cm1.configmgr -b broker1 -w 900

パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用して、メッセージ・フロー top とディクショナリー bar をブローカー b1 の実行グループ default から除去することを試みます。

この実行グループに top および bar という名前の他のオブジェクトがデプロイされていない場合は、-d オプションの値を top:bar に短縮できることに注意してください。
   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
パラメーターが cm1.configmgr ファイルに記述されている接続ファイルを使用してデプロイメントを取り消します。ブローカーが応答するまで 15 分間待ちます。この例では、構成マネージャー が停止し、ドメイン内の未解決デプロイメント要求すべてを待ちます。デプロイメントを取り消す特定のブローカーを指定するには、-b パラメーターを使用します。
mqsideploy -n cm1.configmgr -c -w 900
関連概念
ランタイム環境
関連タスク
デプロイ
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
an09020_