createSIBWMQServer コマンド

createSIBWMQServer コマンドを使用して、セル有効範囲で新しい IBM MQ サーバーを作成します。

このトピックで説明されているように wsadmin ツールを使用するか、 IBM MQ サーバー定義の作成で説明されているように管理コンソールを使用して、新規の IBM MQ サーバーを作成することができます。

コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。

[IBM i] [IBM i] wsadmin スクリプト・クライアントは、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 管理により、 My European area server という名前の IBM MQ サーバー・オブジェクトが作成され、 IBM MQ キュー・マネージャーを serverName QM1で表しているとします。 WebSphere Application Server 管理では、 My UK country serverという名前の 2 番目の IBM MQ サーバー・オブジェクトを作成できます。これも、同じ IBM MQ キュー・マネージャーを serverName QM1で表します。

ターゲット・オブジェクト

WebSphere Application Server セル。

必須パラメーター

-name

IBM MQ サーバーの名前です。この値は管理目的でのみ使用され、管理者が決定することができます。この名前は、 WebSphere Application Server 管理内でのみ意味があり、セル・レベルで固有でなければなりません。デフォルト値はありません。このパラメーターは、変更できません。

-serverName

キュー・マネージャー名またはキュー共有グループ名。この値は、キュー・マネージャーまたはキュー共有グループを識別するための名前であり、 IBM MQ 管理によってその IBM MQ オブジェクトに割り振られます。 WebSphere Application Server 管理者は、常に IBM MQ 管理によって割り振られた名前を使用する必要があります。

-host

キュー・マネージャーまたはキュー共有グループと通信するために接続が確立されるホスト。この値は、この IBM MQ サーバーが表す、キュー・マネージャーまたはキュー共有グループのホスト名または IP アドレスです。この値はストリングであり、以下の 1 つである必要があります。

シンボリック・ホスト名
IPv4 アドレス
IPv6 アドレス

-transportChain

IBM MQとの接続を確立するときに使用するチャネル・フレームワーク・アウトバウンド・トランスポート・チェーン。このオプションを指定しない場合は、OutboundBasicWMQClient のデフォルト値が想定されます。

条件付きパラメーター

なし

オプション・パラメーター

オプションのホスト、ポート、チャネル、および認証別名の各属性はともに、サービス統合で実行されるメッセージング・アプリケーション用に、この IBM MQ サーバーへの接続アクセス・パスを指定します。詳しくは、 IBM MQ サーバー: 接続および認証を参照してください。

-port

この IBM MQ サーバーが表しているキュー・マネージャーまたはキュー共有グループが listen する TCP/IP ポート番号。デフォルト値は 1414 です。

-channel

この IBM MQ サーバーが表すキュー・マネージャーまたはキュー共有グループに接続するときに使用する IBM MQ クライアント・チャネル名。この値は、 IBM MQ 管理によって IBM MQ オブジェクトに割り振られる名前であり、 WebSphere Application Server 管理で常に使用する必要があります。デフォルト値は SYSTEM.DEF.SVRCONN です。

-description

IBM MQ サーバーに関する簡略説明。この値は、管理目的でのみ使用されます。

-securityAuthAlias

キュー・マネージャーまたはキュー共有グループへ接続するときに使用する認証別名。このパラメーターとディスカバリー認証別名とを混同しないでください。

-trustUserIds

IBM MQ からのメッセージで受信したユーザー ID が、サービス統合バスによってメッセージと一緒に渡されるかどうかを決定します。アプリケーション・ユーザー ID は常に jsAppUserId 値から設定されます。これが存在しない場合 (キー / 値のペアが RFH2 ヘッダーに存在しないか、メッセージが RFH2 ヘッダーを保持していない場合)、このフィールドは設定されていません。この値を FALSEに設定すると、ユーザー ID は IBM MQ サーバー名で上書きされます。このパラメーターには、考えられる値が 2 つあります。

TRUE: ユーザー ID はメッセージに伝搬されます。
FALSE: ユーザー ID はメッセージに伝搬されません。

デフォルトは TRUEです。

-allowDiscovery

IBM MQ リソースの自動ディスカバリーを実行するかどうかを決定します。このパラメーターには、考えられる値が 2 つあります。

TRUE: 自動化ディスカバリーが使用されます。
FALSE: 自動化ディスカバリーは使用されません。

デフォルトは TRUEです。

-discoveryAuthAlias

キュー・マネージャーまたはキュー共有グループへのリソース・ディスカバリー接続を確立するときに使用する認証別名。この値をセキュリティー認証別名と混同しないでください。

-replyToQueue

リソース・ディスカバリーのために使用する reply-to キュー。この値は、 IBM MQ 管理によって IBM MQ オブジェクトに割り振られる名前であり、一時動的キューのモデル・キューの名前でなければなりません。 WebSphere Application Server 管理者は、常に IBM MQ 管理によって割り振られた名前を使用する必要があります。デフォルトは SYSTEM.DEFAULT.MODEL.QUEUE です。

-type

IBM MQ サーバー・オブジェクトが、 WebSphere Application Server 管理によって決定されたキュー・マネージャーであるか、キュー共有グループであるかを決定します。このパラメーターの取り得る値は 2 つです。

MQ_QUEUE_MANAGER: IBM MQ サーバーは、キュー・マネージャーを表します。この値を選択した場合、リソース・ディスカバリー・プロセスはキュー・マネージャーに属しているキュー名を取得します。
MQ_QUEUE_SHARING_GROUP: IBM MQ サーバーは、キュー共有グループを表します。この値を選択した場合、リソース・ディスカバリー・プロセスはキュー共有グループに属しているキュー名を取得します。

-bindingsMode

キュー・マネージャーまたはキュー共有グループに接続する場合、バインディング・トランスポート・モード接続を使用するかどうかを決定します。バインディング・モード接続はアプリケーション・サーバーおよびキュー・マネージャーが同じノード上にある場合に、使用することができます。複数のキュー・マネージャーが同じノードにある場合でも、バインディング・モードでは単一のキュー・マネージャーのみにしか接続することができません。このパラメーターには、考えられる値が 2 つあります。

TRUE: 使用可能であれば、バインディング・モードを使用します。このオプションを選択し、バインディング・モードが使用できない場合、接続メカニズムはデフォルトのクライアント・トランスポート・モードになります。
FALSE: 常にクライアント・モードが使用されます。

例

Jython を使用:

wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", 
 "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", 
 "-host", "findep01.ibm.com", "-port", 1414, 
 "-transportChain", "OutboundSecureWMQClient"])

Jacl を使用:

wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" 
-serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true 
-host findep01.ibm.com -port 1414 
-transportChain OutboundSecureWMQClient}