modifySIBWMQServer コマンド
modifySIBWMQServer コマンドを使用して、IBM MQ サーバーを変更します。
このトピックで説明されているように wsadmin ツールを使用するか、IBM MQ サーバー定義の変更で説明されているように管理コンソールを使用して、IBM MQ サーバーを変更することができます。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
- Jython で使用可能なサービス統合バス・コマンドのリストと、各コマンドの簡単な説明を見るには、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('SIBAdminCommands')
- 特定のコマンドの概要ヘルプの場合は、wsadmin プロンプトで以下のコマンドを入力します。
print AdminTask.help('command_name')
コマンドの使用後に、マスター構成に変更を保存します。次のコマンドを使用します。
AdminConfig.save()
目的
IBM MQ サーバーは、IBM MQ キュー・マネージャーまたは (IBM MQ for z/OS の場合) キュー共有グループを表します。このコマンドは、IBM MQ サーバーを変更します。このコマンドを使用して名前や型属性を変更することはできません。
注: IBM MQ サーバーを変更する場合、name 属性および serverName 属性の重要性について認識することが大切です。
例えば、WebSphere Application Server 管理者が、QM1 という serverName の IBM MQ キュー・マネージャーを表している「My European Area Server」という IBM MQ サーバーを作成した場合、管理者はそのあとで、同じキュー・マネージャーを表す、「My UK Country Server」という 2 番目の IBM MQ サーバーを作成することができます。
ターゲット・オブジェクト
選択された IBM MQ サーバー。
必須パラメーター
- -name
- IBM MQ サーバーの名前。名前は IBM MQ サーバー定義を作成するときに指定します。
条件付きパラメーター
なし
オプション・パラメーター
- -serverName
- キュー・マネージャー名またはキュー共有グループ名。この名前によって、 キュー・マネージャーまたはキュー共有グループが識別されます。 値は IBM MQ 管理によって IBM MQ リソースへと割り当てられます。 管理者は常に、IBM MQ 管理によって割り当てられた名前を使用します。
- -host
- host 属性の新規の値。この値は、この IBM MQ サーバーが表すキュー・マネージャーまたはキュー共有グループと通信するときに接続を確立する先のホストの名前または IP アドレスです。
この値はストリングであり、以下の 1 つである必要があります。
- シンボリック・ホスト名
- IPv4 アドレス
- IPv6 アドレス
- -bindingsMode
- bindingsMode 属性の新規の値。この値は
キュー・マネージャーまたはキュー共有グループに接続する際にバインディング・トランスポート・モード接続を
使用するかどうかを決定します。アプリケーション・サーバーおよび
キュー・マネージャーが同じノード上にあるにも関わらず、複数のキュー・マネージャーが同一ノード上に存在する場合でも、
単一のキュー・マネージャーへのみ接続が許可されている場合のみ、バインディング・モード接続が可能です。
このパラメーターには、考えられる値が 2 つあります。
- TRUE
- 使用可能であれば、バインディング・モードを使用します。このオプションを選択し、バインディング・モードが 使用できない場合、接続メカニズムはデフォルトのクライアント・トランスポート・モードになります。
- FALSE
- 常にクライアント・モードが使用されます。
- -port
- IBM MQ port 属性の新規の値。この値は、この IBM MQ サーバーが表すキュー・マネージャーまたはキュー共有グループが listen する TCP/IP ポート番号です。デフォルト値は 1414 です。
- -channel
- IBM MQ channel 属性の新規の値。この値は、この IBM MQ サーバーが表すキュー・マネージャーまたはキュー共有グループに接続する際に使用する IBM MQ クライアント・チャネル名です。 この名前は IBM MQ 管理によって IBM MQ オブジェクトへ割り当てられ、 常に WebSphere Application Server 管理者によって使用される必要があります。 デフォルト値は SYSTEM.DEF.SVRCONN です。
- -description
- description 属性の新規の値。この値は IBM MQ サーバーの簡単な説明であり、管理目的でのみ使用されます。
- -securityAuthAlias
- securityAuthorizationAlias 属性の新規の値。この値は、キュー・マネージャーまたはキュー共有グループに接続する際に使用する認証別名です。 このパラメーターはディスカバリー認証別名とは異なります。
- -transportChain
- transportChain 属性の新規の値。この 値は、IBM MQ との接続を確立する際に使用するアウトバウンド・トランスポート・チェーンです。デフォルト値は OutboundBasicWMQClient です。
- -trustUserIds
- trustUserIds 属性の新規の値。IBM MQ からのメッセージで受信したユーザー ID がメッセージ内に伝搬されるかどうか (すなわち、メッセージ・データの一部として受信したユーザー ID がサービス統合バスで使用されるかどうか) を決定します。
アプリケーション・ユーザー ID は常に jsAppUserId 値から設定されます。
これが存在しない場合 (キー / 値のペアが RFH2 ヘッダーに存在しないか、メッセージが RFH2 ヘッダーを保持していない場合)、この
フィールドは設定されていません。この値を FALSE に設定した場合、ユーザー ID は IBM MQ サーバーの名前で上書きされます。
このパラメーターには、考えられる値が 2 つあります。
- TRUE
- ユーザー ID はメッセージに伝搬されます。
- FALSE
- ユーザー ID はメッセージに伝搬されません。
- -allowDiscovery
- allowDiscovery 属性の新規の値。この値で、IBM MQ リソースの自動化ディスカバリーが行われたかどうかを決定します。このパラメーターには、考えられる値が 2 つあります。
- TRUE
- 自動リソース・ディスカバリーが使用可能になっています。enabled.
- FALSE
- 自動リソース・ディスカバリーが使用不可となっています。
- -discoveryAuthAlias
- discoveryAuthAlias 属性の新規の値。この値は キュー・マネージャーまたはキュー共有グループへのリソース・ディスカバリー接続を確立する際に使用する認証別名であり、セキュリティー認証 別名パラメーターとは異なります。
- -replyToQueue
- replyToQueue 属性の新規の値。この値はリソース・ディスカバリーのために使用する応答キューであり、 IBM MQ 管理によって IBM MQ オブジェクトへ割り当てられる名前です。これは 一時動的キューのモデル名である必要があります。 WebSphere Application Server 管理は常に IBM MQ 管理と同意した名前を使用する必要があります。デフォルトは SYSTEM.DEFAULT.MODEL.QUEUE です。
例
- Jython の使用:
wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM", "-allowDiscovery", "false"] )
- Jacl を使用:
wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM" -allowDiscovery false}