PROVIDERVERSION 指定なし
接続ファクトリーの PROVIDERVERSION プロパティーが指定されていない場合、 JMS クライアントはアルゴリズムを使用して、キュー・マネージャーへの接続に使用する操作モードを決定します。 IBM® MQ classes for JMS の旧バージョンでJNDIネームスペース内に作成されたコネクション・ファクトリーは、 IBM MQ classes for JMS の新バージョンで使用される場合、未指定の値となります。
PROVIDERVERSION プロパティーが指定なしの場合、createConnection メソッドが呼び出されるときにアルゴリズムが使用されます。 このアルゴリズムは、いくつかの接続ファクトリー・プロパティーを検査して、 IBM MQ メッセージング・プロバイダー通常モード、制限付き通常モード、または IBM MQ メッセージング・プロバイダー移行モードが必要かどうかを判別します。 常に通常モードが最初に試行され、次に制限付き通常モードが試行されます。 どちらのタイプの接続も確立できない場合、 JMS クライアントはキュー・マネージャーから切断し、キュー・マネージャーに再度接続して移行モードの接続を試行します。
BROKERVER、 BROKERQMGR、 PSMODE、および BROKERCONQ プロパティーの検査
図 1に示すように、プロパティー値の検査は BROKERVER プロパティーで始まります。
BROKERVER プロパティーが V1に設定されている場合、 図 2に示すように TRANSPORT プロパティーが次にチェックされます。 ただし、 BROKERVER プロパティーが V2に設定されている場合は、 TRANSPORT プロパティーが検査される前に、 図 1 に示す追加の検査が行われます。
BROKERVER プロパティーが V2 に設定されている場合、通常モードの接続を行えるようにするには、BROKERQMGR プロパティーがブランクでなければなりません。 さらに、キュー・マネージャー上の PSMODE 属性が ENABLED に設定されているか、 BROKERCONQ プロパティーで指定されたブローカー制御キューが出力用に開くことができないようになっていなければなりません。
通常モード接続でプロパティー値が必要に応じて設定されている場合は、次にチェック・マークを付けると、 図 2に示すように TRANSPORT プロパティーに移動します。
- BROKERQMGR プロパティーがブランクで、キュー・マネージャー上の PSMODE 属性が COMPAT または DISABLED に設定されており、BROKERCONQ プロパティーで指定されたブローカー制御キューを出力用に開くことができる (つまり、出力の MQOPEN が正常に実行される) 場合。
- BROKERQMGR プロパティーでキュー名が指定されている場合。
TRANSPORT プロパティーとコマンド・レベルの検査
図 2 に、キュー・マネージャーの TRANSPORT プロパティーとコマンド・レベルに対して行われる検査を示します。
- 接続ファクトリーの TRANSPORT プロパティーが BINDINGS に設定され、キュー・マネージャーのコマンド・レベルが 800 以上の場合。
- TRANSPORT プロパティーが CLIENT に設定され、サーバー接続チャネル上の SHARECNV プロパティーの値が 1 以上で、キュー・マネージャーのコマンド・レベルが 800 以上の場合。
キュー・マネージャーのコマンド・レベルが 750 の場合、キュー・マネージャーへの制限付き通常モード接続が作成されます。
TRANSPORT プロパティーが CLIENT に設定され、サーバー接続チャネル上の SHARECNV プロパティーの値が 0 の場合も、移行モードの接続が作成されます。