このフロー制御パラメータの表示
/management/weblogic/{version}/serverConfig/resourceGroupTemplates/{name}/JMSSystemResources/{name}/JMSResource/connectionFactories/{name}/flowControlParams
このフロー制御パラメータを表示します。
リクエスト
- name: string
コレクション内のインスタンスのnameプロパティ。
- version: string
WebLogic RESTインタフェースのバージョン。
- excludeFields(optional): string
'excludeFields'問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これは、フィールド名のカンマ区切りリストです。存在する場合は、名前がリストにないフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます('fields'問合せパラメータが指定されていない場合)。ノート: 'excludeFields'が指定されている場合、'fields'を指定しないでください。
- excludeLinks(optional): string
'excludeLinks'問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これは、リンク関係名のカンマ区切りリストです。存在する場合は、関係名がリストにないリンクのみが返されます。存在しない場合は、すべてのリンクが返されます('links'問合せパラメータが指定されていない場合)。ノート: 'excludeLinks'が指定されている場合、'links'を指定しないでください。
- fields(optional): string
'fields'問合せパラメータは、レスポンスで返されるフィールドを制限するために使用します。これは、フィールド名のカンマ区切りリストです。存在する場合は、名前が一致するフィールドのみが返されます。存在しない場合は、すべてのフィールドが返されます('excludeFields'問合せパラメータが指定されていない場合)。ノート: 'fields'が指定されている場合、'excludeFields'を指定しないでください。
- links(optional): string
'links'問合せパラメータは、レスポンスで返されるリンクを制限するために使用します。これは、リンク関係名のカンマ区切りリストです。存在する場合は、関係名が一致するリンクのみが返されます。存在しない場合は、すべてのリンクが返されます('excludeLinks'問合せパラメータが指定されていない場合)。ノート: 'links'が指定されている場合、'excludeLinks'を指定しないでください。
- Admin: basic
型:
Basic
説明:A user in the Admin security role.
- デプロイヤ: 基本
型:
Basic
説明:A user in the Deployer security role.
- モニター: 基本
型:
Basic
説明:A user in the Monitor security role.
- オペレータ: 基本
型:
Basic
説明:A user in the Operator security role.
レスポンス
- application/json
200レスポンス
このフロー制御パラメータを返します。
object
- flowControlEnabled(optional): boolean
デフォルト値:
true
接続ファクトリを使用して作成されたプロデューサでフローを制御できるかどうかを指定します。trueに設定すると、JMSサーバーまたは宛先が、指定された上限バイト数またはメッセージしきい値に達した場合に、関連するメッセージ・プロデューサが低速化されます。
- flowInterval(optional): integer(int32)
最小値:
0
最大値:2147483647
デフォルト値:60
プロデューサがフローをFlowMaximumのメッセージ数からFlowMinimumに、あるいはその反対に調節するときの調節期間の秒数。
プロデューサがフロー制御されている場合、指定されたFlowIntervalの秒数の間にFlowMaximumからFlowMinimumへと低速化されます。
- flowMaximum(optional): integer(int32)
最小値:
1
最大値:2147483647
デフォルト値:500
しきい値の条件に達したプロデューサで許可される秒当たりの最大メッセージ数。プロデューサがフロー制御されている場合、秒当たりFlowMaximumに指定されたメッセージ数よりも処理を高速化できません。
しきい値の条件に達したときにプロデューサがフローを制限していない場合、そのプロデューサの初期フロー制限がFlowMaximumに設定されます。しきい値の条件に達したときにプロデューサがすでにフローを制限している場合(フロー制限はFlowMaximum未満)、プロデューサは次にフローが評価されるまで現在のフロー制限で処理を継続します。
ノート: いったん、しきい値条件への抵触を回避してからは、プロデューサはフロー限度を無視できなくなります。このフロー制限がFlowMaximum未満の場合、プロデューサはフローが評価されるたびにそのフローを徐々にFlowMaximumまで増やす必要があります。プロデューサがFlowMaximumに達すると、そのフロー制限を無視し、そのフローを制限せずに送信できます。
- flowMinimum(optional): integer(int32)
最小値:
1
最大値:2147483647
デフォルト値:50
しきい値の条件に達したプロデューサで許可される秒当たりの最小メッセージ数。これはプロデューサのフロー制限の下限値。つまり、フロー制限がFlowMinimumに達したプロデューサの処理速度はWebLogic JMSによりそれ以上落とされません。
プロデューサがフロー制御されている場合、秒当たりFlowMinimumのメッセージ数よりもペース・ダウンされる必要はありません。
- flowSteps(optional): integer(int32)
最小値:
1
最大値:2147483647
デフォルト値:10
プロデューサが「最大フロー」のメッセージ数から「最小フロー」に、またはその反対にフローを調整するときに使用するステップ数。具体的には、フロー間隔の調整期間がフロー・ステップ数に分割されます(たとえば、60秒を6ステップで除算するとステップあたり10秒になります)。
また、「最大フロー」と「最小フロー」の差をステップに分割することにより、移動(調整率)が計算されます。各フロー・ステップでは、次のように、現在の条件に基づき必要に応じてフローが上方または下方に調整されます。
下方への移動は、フロー間隔で指定した時間の経過に伴い、フロー・ステップで指定した値に従って幾何的に減衰する(たとえば、100、50、25、12.5など)
上方移動は線形です。差は単純にステップ数で除算されます。
- oneWaySendMode(optional): string
デフォルト値:
disabled
通常の非永続な非トランザクション・メッセージングのパフォーマンスを向上させるために、この接続ファクトリを使用して作成されたメッセージ・プロデューサに、一方向のメッセージ送信を許可するかどうかを指定します。これが有効化されていると、関連付けられたキュー・センダーやトピック・パブリッシャは、ターゲット宛先のホストJMSサーバーからのレスポンスを内部で待機することなく、メッセージを送信できます。
一方向送信は、プロデューサをホストしている接続ファクトリと、ターゲット宛先をホストしているJMSサーバーが、同じWebLogic Serverインスタンスにターゲット指定されている場合にのみサポートされます。加えて、一方向送信は、XA、トランザクション・セッション、永続的なメッセージング、順序単位、作業単位、分散宛先、クライアント側のストア・アンド・フォワードなど、より高度なサービスの品質(QOS)機能については、サポートされません。プロデューサとターゲット宛先が、別個のドメインにある場合、または前述のより高度なQOS機能のいずれかが検出された場合には、一方向モードの設定は無視され、かわりに標準の双方向送信が使用されます。
Disabled 一方向送信は無効化されます。
Enabled 一方向送信は、キュー・センダーまたはトピック・パブリッシャに対して許可されます。
Topic Only トピック・パブリッシャのみが、一方向送信を許可されます。
ノート:
一方向メッセージ送信は、接続ファクトリが「
XA接続ファクトリの有効化
」を指定して構成されている場合には、無効化されます。この設定では、送信側が実際にトランザクションを使用しているかどうかに関係なく、一方向送信が無効になります。一方向のパフォーマンスからメリットを得るには、デフォルトの
One-Way Send Window Size
値も、より大きい値に構成する必要があります。OneWaySendWindowSize - 1
個のメッセージごとに、一方向ではなく双方向が使用されるため、OneWaySendWindowSize = 1
の場合、すべてのメッセージが実際には双方向となります。
- oneWaySendWindowSize(optional): integer(int32)
最小値:
1
最大値:2147483647
デフォルト値:1
One-Way Send Mode
が、キュー・センダーやトピック・パブリッシャによる一方向送信を許可するように設定されている場合に、ウィンドウごとの送信されるメッセージの最大数を指定します。ウィンドウ・サイズでは、さらなる一方向送信を続行できるようになる前に、プロデューサを規定するため双方向メッセージが必要な場合が決定されます。一方向のパフォーマンスでメリットを得るためには、一方向送信を有効化するのみでなく、デフォルトの
One-Way Send Window Size
値を、より大きい値に構成する必要があります。OneWaySendWindowSize - 1
個のメッセージごとに、一方向ではなく双方向が使用されるため、OneWaySendWindowSize = 1
の場合、すべてのメッセージが実際には双方向となります。