ポリシーしきい値

ポリシー・ルールを使用して、いくつかの異なるタイプのしきい値を定義できます。 同じしきい値を持つ複数のポリシー・ルールがデプロイされると、トリガーされるルールの順序は、メッセージ・アクション・ルールが最初で、次にイベント・アクション・ルール、最後は異常終了アクション・ルールになります。

サポートされるルール・タイプの詳細

表 1. サポートされるルール・タイプの詳細
ルール・タイプ  1  ルール項目  2  演算子  3  単位  4 

データベース要求

SQL コマンド

より大きい

""
要求数
K
1000 個の要求数

ファイル要求

削除
読み取り
次の読み取り
直前の読み取り
読み取りと更新
再書き込み
ブラウズの開始
書き込み

より大きい

""
要求数
K
1000 個の要求数

プログラム要求

リンク

より大きい

""
要求数
K
1000 個の要求数

ストレージ

24 ビット・タスク・ストレージ
31 ビット・タスク・ストレージ
64 ビット・タスク・ストレージ
24 ビット共用ストレージ
31 ビット共用ストレージ
64 ビット共用ストレージ

より大きい

B
バイト
K
キロバイト
M
メガバイト
G
ギガバイト

ストレージ要求

24 ビット・タスク・ストレージ要求
31 ビット・タスク・ストレージ要求
64 ビット・タスク・ストレージ要求
24 ビット共用ストレージ要求
31 ビット共用ストレージ要求
64 ビット共用ストレージ要求

より大きい

""
要求数
K
1000 個の要求数

時間

CPU 制限

より大きい

O
マイクロ秒
M
ミリ秒
S
注: 単位を選択して、しきい値の値をポリシー・ルールに指定するときは、 単位のサイズが大きいほど細分度が小さくなることに注意してください。 高い単位を使用した際に十分に高い値を指定できない場合には、 より低い (より小さい) 単位を使用することで適切な値が指定可能になることがあります。 例えば、ストレージ・タイプのポリシー・ルールを作成するとき、 単位に "G" (ギガバイト) を使用するとしきい値を設定できない場合には、単位に "M" (メガバイト) を使用して、 ポリシー・ウィザードの「値」フィールドにメガバイトの相当値を入力することにより、 しきい値の設定が可能になることがあります。

以下の例では、storage ポリシーおよび filerequest ポリシーの XML を示します。 このポリシーは、タスクが 1024 バイトより大きい 24 ビット・タスク・ストレージを割り振るとき、またはタスクが 50 ファイルより多くの読み取りを実行するときに、メッセージ DFHMP3001 を発行します。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Example platform policy to monitor task storage and file read counts</description>
   <userTag>exmp_1</userTag> thru <userTag>exmp_3</userTag>
   <rule type="storage" 1 > 
      <name>TooMuch24BitStorage</name> 
      <description>Issue DFHMP3001 msg when a task allocate more than 1024 bytes of 24 bit task storage</description>      
      <storageUsedCondition item="task24" 2  operator="GT" 3  value="1" unit="K" 4 />      
      <action>
         <message/>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>TooManyReads</name> 
      <description>Issue DFHMP3001 msg when a task does more than 50 reads</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="50" unit="" 4 />
      <action>
         <message/>  
      </action> 
   </rule> 
</policy:policy>
以下の例では、タスクを異常終了する filerequest ポリシーの XML を示します。 このポリシーは、タスクが 10000 ファイルより多くの読み取りを実行する場合に、デフォルトの異常終了コード AMPB でタスクを異常終了します。また、タスクが 5000 ファイルより多くの書き込みを実行する場合に、ユーザー指定の異常終了コード CFI1 でタスクを異常終了します。 異常終了とともに、メッセージ DFHMP3002 が発行されます。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Policy to monitor the number of file reads</description>
   <userTag>fcpol_1</userTag> 
   <rule type="filerequest" 1 > 
      <name>File_Reads</name> 
      <description>Abend the task if the file read limit exceeded</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="10" unit="K" 4 />      
      <action>
         <abend/>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>File Write</name> 
      <description>Abend the task with specified abend code CFI1 if the file write limit exceeded</description>      
      <fileRequestCondition item="write" 2  operator="GT" 3  value="5" unit="K" 4 />
      <action>
         <abend abendCode="CFI1"/>  
      </action> 
   </rule> 
</policy:policy>
以下の例では、イベントを発行する filerequest ポリシーの XML を示します。 このポリシーは、タスクが 500 ファイルより多くの書き込みを実行する場合に、adapterB という名前のイベント・アダプターにイベントを発行します。また、タスクが 100 ファイルより多くの読み取りを実行する場合に、adaSetA という名前のイベント・アダプター・セットにイベントを発行します。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policy:policy xmlns:policy="http://www.ibm.com/xmlns/prod/cics/managedplatform/policy" policySchemaRelease="0" policySchemaVersion="1">
   <description>Policy to monitor the number of file reads</description>
   <userTag>fcpol_1</userTag> 
   <rule type="filerequest" 1 > 
      <name>File Write</name> 
      <description>The file write limitation policy</description>      
      <fileRequestCondition item="write" 2  operator="GT" 3  value="500" unit="" 4 />      
      <action>
         <event>  
            <eventAdapterName>adapterB</eventAdapterName> 
         </event>  
      </action> 
   </rule>
   <rule type="filerequest" 1 > 
      <name>File_Reads</name> 
      <description>File read limitation policy</description>      
      <fileRequestCondition item="read" 2  operator="GT" 3  value="100" unit="" 4 />
      <action>
         <event>  
            <eventAdapterSetName>adaSetA</eventAdapterSetName> 
         </event>  
      </action> 
   </rule> 
</policy:policy>
表 1に示されているルール・タイプの詳細が、 XML パラメーターおよび値にどのようにマップされるかについて詳しくは、 ポリシー XML エレメント名および属性の値を参照してください。