アプリケーションは、接続ファクトリーを使用して接続を作成します。
xms::PropertyContext | +----xms::ConnectionFactory
ConnectionFactory オブジェクトの XMS 定義プロパティーのリストについては、ConnectionFactory のプロパティーを参照してください。
メソッド | 説明 |
---|---|
~ConnectionFactory | 接続ファクトリーを削除します。 |
createConnection | デフォルトのユーザー ID を使用して接続を作成します。 |
createConnection | 指定されたユーザー ID を使用して接続を作成します。 |
getHandle | C アプリケーションが接続ファクトリーにアクセスするときに使用するハンドルを取得します。 |
isNull | ConnectionFactory オブジェクトがヌル・オブジェクトであるかどうかを判別します。 |
Connection createConnection();
接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、アプリケーションの認証に使用されます。これらのプロパティーが設定されていない場合、メッセージング・サーバーが認証なしの接続を許可しているのであれば、アプリケーションを認証せずに接続が作成されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、このプロパティーは無視されます。
接続は停止済みモードで作成されます。 アプリケーションが Connection.start() を呼び出すまで、メッセージは配信されません。
Connection createConnection(const String & userID, const String & password);
アプリケーションの認証に、指定したユーザー ID およびパスワードが使用されます。接続ファクトリーのプロパティー XMSC_USERID および XMSC_PASSWORD は、設定されている場合、無視されます。アプリケーションがバインディング・モードで WebSphere MQ キュー・マネージャーに接続する場合、ユーザー ID およびパスワードは無視されます。
接続は停止済みモードで作成されます。 アプリケーションが Connection.start() を呼び出すまで、メッセージは配信されません。