mqsichangeproperties コマンド

mqsichangeproperties コマンドを使用して、ブローカー・プロパティーおよびブローカー・リソースのプロパティーを変更します。

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

  • Windows® システム。
  • Linux® および UNIX® システム。
  • z/OS®. BIPCHPR ユーティリティーをカスタマイズして実行依頼することにより、このコマンドを実行します。ブローカー PDSE の内容を参照してください。

目的

mqsichangeproperties コマンドは、ブローカー間の通信、JVM、および HTTP リスナー・コンポーネント (HTTPInput および HTTPReplyノードの HTTP および HTTPS (SSL) サポートを含む) に関係するプロパティーに変更を加える場合に使用します。 また、構成マネージャー・プロキシー (CMP) API を使用してプロパティーを変更することもできます。

変更の始まりmqsireportproperties コマンドを使用して、 ブローカーに関連付けられたプロパティーを表示します。変更の終わり

使用上の注意

  • mqsichangeproperties コマンドを実行する前に、ブローカーが実行されていることを確認してください。
  • いずれかの値を変更した場合、その変更を有効にするには、ブローカーを停止して再始動してください。
  • 変更の始まりHTTP ノード が含まれるメッセージ・フローの開始時に、ブローカーは HTTP リスナーを始動します。変更の終わり

構文

パラメーター

BrokerName
(必須) 変更するブローカーの名前。このパラメーターは、最初のパラメーターでなければなりません。

 

-b httplistener
(オプション) コンポーネントの名前。

変更の始まり-b httplistener または -c ConfigurableService のいずれかを指定する必要があります。変更の終わり

-c ConfigurableService
(オプション) 構成可能サービスのタイプ。 タイプは、例えば JMSProviders などと、事前定義されています。 mqsicreateconfigurableservice コマンドを使用して、任意の定義済みタイプに対して追加のサービスを定義できます。

変更の始まり-b httplistener または -c ConfigurableService のいずれかを指定する必要があります。変更の終わり

-o ObjectName
(必須) プロパティーに変更を加えるオブジェクトの名前。

前のバージョンとの互換性のために、ObjectName に値 ComIbmXmlParserFactory も指定できます。

-n PropertyName
(必須) 変更されるプロパティーの名前。 すべてのプロパティー名は、小文字から始まります。
-v PropertyValue
(必須) -n パラメーターで指定されるプロパティーに割り当てられる値。

変更の始まり対応するプロパティーに有効な値を使用していれば、分離文字としてコンマを使用して、複数のプロパティー名をその対応する値とともに指定できます。 例えば、-n Name1,Name2 -v Value1,Value2 のようにします。変更の終わり

変更の始まり名前および対応する値のリスト内の各コンマの後にスペースを残さないでください。変更の終わり

空の PropertyValue ストリングを指定するには、"" を使用します。

mqsichangeproperties WBRK_BROKER -c JDBCProviders -o DB2EXTRA -n connectionUrlFormat
-v "jdbc:db2://[serverName]:[portNumber]/[databaseName]:user=[user];password=[password];"

 

変更の始まり有効なコンポーネント、構成可能サービス、オブジェクト名、プロパティー、および値について詳しくは、以下の適切なトピックを選択してください。 変更の終わり

許可

Windows システムでは、このコマンドを実行するのに使用するユーザー ID は、ローカル・コンピューター上の Administrators グループのメンバーでなければなりません。

Linux and UNIX システムでは、このコマンドを呼び出すのに使用するユーザー ID は、mqbrkrs グループのメンバーでなければなりません。

さらに、ブローカーにはサポートされるマルチキャスト・プロトコルについて以下の権限が必要です。
PGM/IP
ブローカーに以下の権限が必要です。
  • Linux platformUNIX platform Linux および UNIX システムの場合、root 権限
  • Windows platform Windows システムの場合、Administrator 権限
  • z/OS platform z/OS の場合、root 権限 (UNIX システム・サービスのみ)
PGM/UDP
サポートされているすべてのプラットフォームで、ブローカーに User 権限が必要です。
PTL
サポートされているすべてのプラットフォームで、ブローカーに User 権限が必要です。

コマンドは常に 1 行で入力します。 いくつかの例では、読みやすいように改行しています。

ブローカー・コンポーネントに対する変更

以下の例では、-b パラメーターを指定して特定のブローカー・コンポーネントを識別しています。

  • 指定されたブローカーにデプロイされた HTTP ノード用に HTTPSConnector を使用可能にします。
     mqsichangeproperties TEST -b httplistener -o HTTPListener -n enableSSLConnector -v true
  • 指定されたブローカーにデプロイされた HTTP ノード用に、デフォルト SSL プロトコルを SSLv3 から TLS に変更します。
    mqsichangeproperties TEST  -b httplistener -o HTTPSConnector -n sslProtocol -v TLS 

実行グループに関連付けられたプロパティーに対する変更

以下の例には、変更する実行グループを指定するための -e パラメーターが含まれています。

  • 複製されたブローカーに対して clientPingInterval を 200 に変更します。
    mqsichangeproperties TEST -e default -o DynamicSubscriptionEngine -n clientPingInterval -v 200 
  • 複製されたブローカーに対してマルチキャストを使用可能にします。
    mqsichangeproperties TEST -e default -o DynamicSubScriptionEngine -n multicastEnabled -v true
  • メッセージ・フローのデバッグを活動化するための JVM ポート番号を設定します。
    mqsichangeproperties TEST -e exgroup1 -o ComIbmJVMManager -n jvmDebugPort -v 8018 
  • サーバー鍵ストアのタイプを設定します。
    mqsichangeproperties TEST -e AddressSampleProvider -o ComIbmJVMManager -n keystoreType -v JKS

構成可能サービスに対する変更

以下の例には、変更する構成可能サービスのタイプを指定するための -c パラメーターが含まれています。

  • IBM® WebSphere® MQ JMS クライアントの JAR ファイルの位置を変更します。
    mqsichangeproperties WBRK6_DEFAULT_BROKER -c JMSProviders -o WebSphere_MQ
    -n jarsURL -v file://D:¥SIBClient¥Java
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
最終更新 : 2009-02-20 12:44:13

an09140_