JMS キュー接続ファクトリー (jmsQueueConnectionFactory)
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 キュー接続ファクトリーは、point-to-point メッセージングで、JMS キューの、関連した JMS プロバイダーへの接続を作成するために使用されます。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 busName string defaultBus 完全プロファイル・サーバー内のサービス統合バスに 接続するときのバスの名前。 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 です。詳しくは、インフォメーション・センターを参照してください。 targetTransportChain string トランスポート・チェーンは、フルプロファイル・サーバー上のサービス統合バスと通信するために使用できる通信プロトコルを指定します。 temporaryQueueNamePrefix string temp このキュー接続ファクトリーを使用するアプリケーションによって作成される一時キューに使用される、12 文字までの接頭部。 userName string このプロパティーを構成する代わりに、コンテナー管理認証別名を使用することをお勧めします。
- properties.wmqJms
説明: WebSphere MQ JMS キュー接続ファクトリー。必須: falseデータ型: 属性名 データ型 デフォルト値 説明 CCSID int 最小: 1
819 接続用のコード化文字セット ID。 applicationName string アプリケーションをキュー・マネージャーに登録する際に使用した名前。 arbitraryProperties string 他で定義されていないプロパティーの指定を可能にします。 ccdtURL string クライアント・チャネル定義テーブル (CCDT) が格納されているファイルの名前と場所を識別し、このファイルのアクセス方法を指定する URL。 channel string 使用する MQI チャネルの名前。 clientId string 接続用のクライアント ID。 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
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
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 接続と共有できるかどうか。 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
SSL によって使用された秘密鍵の再ネゴシエーションの前に、SSL 接続で送信および受信したバイトの総数。 targetClientMatching boolean true 着信メッセージの JMSReplyTo ヘッダー・フィールドで識別されるキューに送信された応答メッセージに MQRFH2 ヘッダーがあるかどうか (着信メッセージに MQRFH2 ヘッダーがある場合のみ)。 tempQPrefix string WebSphere MQ 動的キューの名前を形成するために使用された接頭部。 temporaryModel string JMS 一時キューの作成に使用するモデル・キューの名前。SYSTEM.JMS.TEMPQ.MODEL を JMS レイヤーで使用して、永続メッセージを受け入れるキューを作成できます。これは、デフォルト値では実行できません。SYSTEM.DEFAULT.MODEL.QUEUE を 開くことができるのは 1 回だけです。SYSTEM.JMS.TEMPQ.MODEL は 2 回以上開くことができます。SYSTEM.DEFAULT.MODEL.QUEUE の使用は推奨されません。 transportType - CLIENT
- BINDINGS
CLIENT キュー・マネージャーへの接続で、クライアント・モードまたはバインディング・モードのどちらを使用するか。 - CLIENT
- CLIENT
- BINDINGS
- BINDINGS
userName string キュー・マネージャーへの接続を作成する際に使用するデフォルト・ユーザー名。(このプロパティーを構成するよりも、コンテナー管理認証別名を使用することを推奨します)
参照トピック