JMS トピック接続ファクトリー (jmsTopicConnectionFactory)
JMS トピック接続ファクトリー構成を定義します。
| 属性名 | データ型 | デフォルト値 | 説明 |
|---|---|---|---|
| connectionManagerRef | 最上位の connectionManager エレメント (ストリング) の参照。 | 接続ファクトリーの接続マネージャー。 | |
| containerAuthDataRef | 最上位の authData エレメント (ストリング) の参照。 | res-auth=CONTAINER であるリソース参照用の認証別名がバインディングで指定されていない場合に適用される、コンテナー管理認証のデフォルトの認証データ。 | |
| id | string | 固有の構成 ID。 | |
| jndiName | string | リソースの JNDI 名。 | |
| recoveryAuthDataRef | 最上位の authData エレメント (ストリング) の参照。 | トランザクション・リカバリーの認証データ。 |
- connectionManager
説明: 接続ファクトリーの接続マネージャー。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 agedTimeout 期間 (精度: 秒) -1 プールの保守により物理接続を破棄できるようになるまでの時間。値が -1 の場合、このタイムアウトは無効になります。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 connectionTimeout 期間 (精度: 秒) 30s この時間が経過すると、接続要求がタイムアウトになります。値が -1 の場合、このタイムアウトは無効になります。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 maxConnectionsPerThread int 最小: 0
各スレッドのオープン接続の数を制限します。 maxIdleTime 期間 (精度: 秒) 30m この時間が経過すると、使用されていない接続、つまりアイドル接続をプールの保守中に破棄することができます (接続の破棄によってプールが最小サイズよりも小さくならない場合)。値が -1 の場合、このタイムアウトは無効になります。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。 maxPoolSize int 最小: 0
50 プールの物理接続の最大数。値が 0 の場合、無制限であることを示します。 minPoolSize int 最小: 0
プールで保守する物理接続の最小数。プールに接続は事前に入っていません。経過タイムアウトにより、この最小数を割り込むことがあります。 numConnectionsPerThreadLocal int 最小: 0
スレッドごとに指定された数の接続をキャッシュに入れます。 purgePolicy - ValidateAllConnections
- FailingConnectionOnly
- EntirePool
EntirePool 失効した接続がプールで検出された場合にどの接続を破棄するかを指定します。 - ValidateAllConnections
- 失効した接続が検出されると、接続がテストされ、不良と認められた接続がクローズされます。
- FailingConnectionOnly
- 失効した接続が検出されると、不良と認められた接続のみがクローズされます。
- EntirePool
- 失効した接続が検出されると、プール内のすべての接続が失効とマーク付けされ、もう使用されていない場合に、クローズされます。
reapTime 期間 (精度: 秒) 3m プール保守スレッドの実行とその次の実行との間の時間。値が -1 の場合、プール保守は無効になります。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、または秒 (s) が可能です。例えば、30 秒は 30s と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1m30s は 90 秒に相当します。
- containerAuthData
説明: res-auth=CONTAINER であるリソース参照用の認証別名がバインディングで指定されていない場合に適用される、コンテナー管理認証のデフォルトの認証データ。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 password リバース・エンコードされたパスワード (ストリング) EIS への接続時に使用するユーザーのパスワード。値は、平文形式またはエンコード形式で格納できます。パスワードはエンコードすることが推奨されます。これを行うには、securityUtility ツールで encode オプションを指定します。 user string EIS への接続時に使用するユーザーの名前。
- properties.wasJms
説明: JMS トピック接続ファクトリーは、パブリッシュ/サブスクライブ・メッセージング用に、JMS 宛先の関連付けられている JMS プロバイダーとの接続を作成するために使用されます。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 busName string defaultBus 完全プロファイル・サーバー内のサービス統合バスに 接続するときのバスの名前。 clientID string clientID すべての接続上の永続 (および共有非永続) トピック・サブスクリプションに必要な JMS クライアント ID。この ID は、アプリケーションが永続的 (および共有非永続的) パブリッシュ/サブスクライブ・メッセージングを行っている場合に必要です。 durableSubscriptionHome string defaultME 永続サブスクリプション・ホームは、接続を確立する必要がある ME 名を定義します。 nonPersistentMapping - BestEffortNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
ExpressNonPersistent この接続ファクトリーを使用して送信される非永続 JMS メッセージに適用される信頼性。 - BestEffortNonPersistent
- BestEffortNonPersistent
- ReliableNonPersistent
- ReliableNonPersistent
- ExpressNonPersistent
- ExpressNonPersistent
password リバース・エンコードされたパスワード (ストリング) このプロパティーを構成する代わりに、コンテナー管理認証別名を使用することをお勧めします。 persistentMapping - AssuredPersistent
- ReliablePersistent
ReliablePersistent この接続ファクトリーを使用して送信される永続 JMS メッセージに適用される信頼性。 - AssuredPersistent
- AssuredPersistent
- ReliablePersistent
- ReliablePersistent
readAhead - AlwaysOff
- デフォルト
- AlwaysOn
デフォルト 先読みとは、コンシューマーにメッセージを事前に割り当てる最適化処理のことです。これによって、コンシューマー要求の処理が速くなります。 - AlwaysOff
- AlwaysOff
- デフォルト
- デフォルト
- AlwaysOn
- AlwaysOn
remoteServerAddress string ブートストラップ・サーバーへの接続に使用される、 コンマで区切られたトリプレットで表されるリモート・サーバー・アドレス (構文は hostName:portNumber:chainName)。例えば、Merlin:7276:BootstrapBasicMessaging です。hostName が指定されない場合、デフォルトは localhost です。portNumber が指定されない場合、デフォルトは 7276 です。chainName が指定されない場合、デフォルトは BootstrapBasicMessaging です。詳しくは、インフォメーション・センターを参照してください。 shareDurableSubscription string 永続サブスクリプションを複数の接続で共有できるかどうかを 制御します。 targetTransportChain string トランスポート・チェーンは、フルプロファイル・サーバー上のサービス統合バスと通信するために使用できる通信プロトコルを指定します。 temporaryTopicNamePrefix string temp このトピック接続ファクトリーを使用するアプリケーションによって作成される一時トピックに使用される、12 文字までの接頭部。 userName string このプロパティーを構成する代わりに、コンテナー管理認証別名を使用することをお勧めします。
- properties.wmqJms
説明: WebSphere MQ JMS トピック接続ファクトリー必須: falseデータ型: 属性名 データ型 デフォルト値 説明 CCSID int 最小: 1
819 接続用のコード化文字セット ID。 applicationName string アプリケーションをキュー・マネージャーに登録する際に使用した名前。 arbitraryProperties string 他で定義されていないプロパティーの指定を可能にします。 brokerCCSubQueue string 接続コンシューマーが非永続サブスクリプション・メッセージを受信するキューの名前 brokerControlQueue string ブローカー制御キューの名前 brokerPubQueue string パブリッシュ済みメッセージが送信されたキュー (ストリーム・キュー) の名前。 brokerQueueManager string ブローカーが稼働しているキュー・マネージャーの名前 brokerSubQueue string 非永続メッセージ・コンシューマーがメッセージを受信するキューの名前 brokerVersion - 2
- 1
使用されているブローカーのバージョン - 2
- 2
- 1
- 1
ccdtURL string クライアント・チャネル定義テーブル (CCDT) が格納されているファイルの名前と場所を識別し、このファイルのアクセス方法を指定する URL。 channel string 使用する MQI チャネルの名前。 cleanupInterval 期間 (精度: ミリ秒) パブリッシュ/サブスクライブ・クリーンアップ・ユーティリティーがバックグラウンドで実行する間隔 (ミリ秒)。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 cleanupLevel - SAFE
- FORCE
- NONDUR
- NONE
- STRONG
SAFE ブローカー・ベースのサブスクリプション・ストアのクリーンアップ・レベル。 - SAFE
- SAFE
- FORCE
- FORCE
- NONDUR
- NONDUR
- NONE
- NONE
- STRONG
- STRONG
clientId string 接続用のクライアント ID cloneSupport - ENABLED
- DISABLED
DISABLED 1 つの永続トピック・サブスクライバーの複数のインスタンスを同時に稼働できるかどうか。 - ENABLED
- ENABLED
- DISABLED
- DISABLED
connectionNameList string 通信に使用される TCP/IP 接続名 (hostname(port)) のリスト。hostname プロパティーおよび port プロパティーは、ConnectionNameList に置き換えられます。 failIfQuiesce boolean true キュー・マネージャーが静止状態の場合、特定のメソッドの呼び出しが失敗するかどうか。 headerCompression - SYSTEM
- NONE
NONE 接続のヘッダー・データを圧縮するために使用できる技法のリスト - SYSTEM
- SYSTEM
- NONE
- NONE
hostName string キュー・マネージャーが存在しているシステムのホスト名または IP アドレス。ConnectionNameList プロパティーを指定すると、ホスト名とポートのプロパティーは ConnectionNameList プロパティーに置き換えられます。 localAddress string このプロパティーは、 キュー・マネージャーへの接続について、次のいずれか、または両方を指定します。(1) 使用 されるローカル・ネットワーク・インターフェース。(2) 使用されるローカル・ポート、またはローカル・ポートの範囲。 messageCompression - RLE
- NONE
NONE 接続のメッセージ・データを圧縮するために使用できる技法のリスト。 - RLE
- RLE
- NONE
- NONE
messageSelection - CLIENT
- BROKER
CLIENT メッセージの選択を、WebSphere MQ classes for JMS またはブローカーのどちらが行うかを決定します。 - CLIENT
- CLIENT
- BROKER
- BROKER
password リバース・エンコードされたパスワード (ストリング) キュー・マネージャーへの接続を作成する際に使用するデフォルト・パスワード。 (このプロパティーを構成するよりも、コンテナー管理認証別名を使用することを推奨します) pollingInterval 期間 (精度: ミリ秒) この値は、各セッション内のメッセージ・リスナーのキューに適切なメッセージがない場合に、各メッセージ・リスナーがキューからメッセージの取得を再度試みるまでの最大の時間間隔 (ミリ秒) です。セッション内のいずれのメッセージ・リスナーにも適切なメッセージがない状態が頻繁に発生する場合は、このプロパティーの値を増やすことを検討してください。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 port int 最小: 1
1414 キュー・マネージャーが listen を行うポート。ConnectionNameList プロパティーを指定すると、ホスト名とポートのプロパティーは ConnectionNameList プロパティーに置き換えられます。 providerVersion - 7
- 6
- unspecified
unspecified アプリケーションが接続することになっているキュー・マネージャーのバージョン、リリース、修正レベル、およびフィックスパック - 7
- 7
- 6
- 6
- unspecified
- unspecified
pubAckInterval int 最小: 0
25 WebSphere MQ classes for JMS がブローカーからの確認通知を要求するまでに、パブリッシャーによって公開されるメッセージの数 queueManager string 接続するキュー・マネージャーの名前 receiveExit string チャネル受信出口プログラム、または連続して実行される一連の受信出口プログラムを識別します。 receiveExitInit string チャネル受信出口プログラムが呼び出されたときに、その出口プログラムに渡されるユーザー・データ rescanInterval 期間 (精度: ミリ秒) 5s Point-to-Point ドメインのメッセージ・コンシューマーがメッセージ・セレクターを使用して受信するメッセージを選択する場合、WebSphere MQ classes for JMS は WebSphere MQ キューを検索して、このキューの MsgDeliverySequence 属性によって決定される順序で適切なメッセージを探します。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 securityExit string チャネル・セキュリティー出口プログラムを識別します。 securityExitInit string チャネル・セキュリティー出口プログラムが呼び出されたときに、その出口プログラムに渡されるユーザー・データ sendCheckCount int 最小: 0
単一の未処理 JMS セッション内で、非同期書き込みエラーの検査が行われてから次の検査が行われるまでに許可される送信呼び出しの数。 sendExit string チャネル送信出口プログラム、または連続して実行される一連の送信出口プログラムを識別します。 sendExitInit string チャネル送信出口プログラムが呼び出されたときに、その出口プログラムに渡されるユーザー・データ。 shareConvAllowed boolean true チャネル定義が一致する場合に、クライアント接続がそのソケットを同じプロセスから同じキュー・マネージャーへの他のトップレベル JMS 接続と共有できるかどうか。 sparseSubscriptions boolean false TopicSubscriber オブジェクトのメッセージ検索ポリシーを制御する。 sslCertStores string SSL 接続で使用する証明書失効リスト (CRL) を保持する Lightweight Directory Access Protocol (LDAP) サーバー。 sslCipherSuite string SSL 接続で使用する CipherSuite。 sslFipsRequired boolean IBM Java JSSE FIPS プロバイダー (IBMJSSEFIPS) がサポートする CipherSuite を SSL 接続で使用する必要があるかどうか。 sslPeerName string SSL 接続で、キュー・マネージャーで提供されるデジタル証明書の識別名を確認するために使用するテンプレート。 sslResetCount int 最小: 0
最大: 999999999
0 SSL によって使用された秘密鍵の再ネゴシエーションの前に、SSL 接続で送信および受信したバイトの総数。 statusRefreshInterval 期間 (精度: ミリ秒) 1m サブスクライバーがキュー・マネージャーとの接続を失ったときに検出する長期実行トランザクションのリフレッシュの間隔 (ミリ秒)。このプロパティーは、サブスクリプション・ストアの値が QUEUE の場合にのみ使用されます。正整数とその後に時間単位を指定します。時間単位には、時間 (h)、分 (m)、秒 (s)、またはミリ秒 (ms) が可能です。例えば、500 ミリ秒は 500ms と指定します。1 つのエントリーに複数の値を含めることができます。例えば、1s500ms は 1.5 秒に相当します。 subscriptionStore - MIGRATE
- BROKER
- QUEUE
BROKER WebSphere MQ classes for JMS がアクティブ・サブスクリプションに関する永続データを保管する場所を決定します。 - MIGRATE
- MIGRATE
- BROKER
- BROKER
- QUEUE
- QUEUE
targetClientMatching boolean true 着信メッセージの JMSReplyTo ヘッダー・フィールドで識別されるキューに送信された応答メッセージに MQRFH2 ヘッダーがあるかどうか (着信メッセージに MQRFH2 ヘッダーがある場合のみ)。 tempTopicPrefix string 一時トピックの作成時に、JMS は TEMP/TEMPTOPICPREFIX/unique_id という形式のトピック・ストリングを生成します。またはこのプロパティーがデフォルト値のままになっている場合、TEMP/unique_id のみ生成します。空でない TEMPTOPICPREFIX を指定すると、この接続の下で作成された一時トピックに対して、サブスクライバー用の管理されたキューを作成するための特定のモデル・キューを定義できます。 transportType - CLIENT
- BINDINGS
CLIENT キュー・マネージャーへの接続で、クライアント・モードまたはバインディング・モードのどちらを使用するか。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
userName string キュー・マネージャーへの接続を作成する際に使用するデフォルト・ユーザー名。(このプロパティーを構成するよりも、コンテナー管理認証別名を使用することを推奨します) wildcardFormat - CHAR
- TOPIC
TOPIC 使用されるワイルドカード構文のバージョン。 - CHAR
- CHAR
- TOPIC
- TOPIC
参照トピック