原則臨界值

您可以使用原則規則來定義數個不同類型的臨界值。部署具有相同臨界值的多個原則規則時,觸發規則的順序是先觸發 message 動作規則,再觸發 event 動作規則,最後觸發 abend 動作規則。

支援的規則類型詳細資料

表 1. 支援的規則類型詳細資料
規則類型  1  規則項目  2  運算子  3  單位  4   5 

資料庫要求

SQL 指令

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

檔案要求

刪除指令
讀取指令
讀取下一個指令
讀取前一個指令
讀取更新指令
重寫指令
開始瀏覽指令
寫入指令

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

要求或千個要求的這些值範圍適用於所有的「檔案要求」原則規則項目。

程式要求

LINK 指令

註: INVOKE APPLICATION 指令亦包含在計數中,但不是個別原則項目。

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

啟動要求

START 指令

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

儲存體

24 位元作業儲存體
24 位元共用儲存體

31 位元作業儲存體
31 位元共用儲存體

64 位元作業儲存體
64 位元共用儲存體

大於

B
位元組
K
KB
M
MB
G
GB

24 位元規則項目:

B
0 - 16777215
K
0 - 16383
M
0 - 15
G
0

31 位元規則項目:

B
0 - 2147483647
K
0 - 2097151
M
0 - 2047
G
0 - 1

64 位元規則項目:

B
0 - 4294967295
K
0 - 4294967295
M
0 - 4294967295
G
0 - 4294967295

儲存體要求

24 位元作業儲存體要求
24 位元共用儲存體要求

31 位元作業儲存體要求
31 位元共用儲存體要求

64 位元作業儲存體要求
64 位元共用儲存體要求

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

要求或千個要求的這些值範圍適用於所有的「儲存體要求」原則規則項目。

同步點要求

SYNCPOINT 指令

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

TD 佇列要求

READQ TD 指令
WRITEQ TD 指令

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

要求或千個要求的這些值範圍適用於所有的「TD 佇列要求」原則規則項目。

時間

CPU 時間
經歷時間

大於

O
微秒
M
毫秒
S
O
0 - 4294967295
M
0 - 86400000
S
0 - 86400(值 86400 等於 24 小時)

TS 佇列位元組

WRITEQ TS 指令
WRITEQ TS auxiliary 指令
WRITEQ TS main 指令

註:
  • WRITEQ 原則項目會用來為寫入至所有 TSQ 組合的資料量設定臨界值。其他原則項目則用來設定特定 TSQ 類型的臨界值。
  • WRITE 和 REWRITE 要求都寫入的資料,會被納入總計,而 REWRITE 要求會被視為 WRITE 作業,因為計數將會依據 REWRITE 的大小總計增加,並不是原始 WRITE 和 REWRITE 之間的差異。
  • 只有在 WRITEQ 順利執行時,才會將資料納入計數。

大於

B
位元組
K
KB
M
MB
G
GB
B
0 - 4294967295
K
0 - 4194303
M
0 - 4095
G
0 - 3

所有的「TS 佇列位元組」原則規則項目都具有相同的值範圍。

TS 佇列要求

READQ TS 指令
WRITEQ TS 指令
WRITEQ TS auxiliary 指令
WRITEQ TS main 指令

註: READQWRITEQ 原則項目可用來設定對輔助和主要 TSQ 組合發出的 READ 或 WRITE 要求總數的臨界值。另一個 WRITEQ 原則項目則用來設定對特定 TSQ 類型發出之 WRITE 要求數的臨界值。

大於

""
要求
K
千個要求
""
0 - 4294967295
K
0 - 4294967

要求或千個要求的這些值範圍適用於所有的「TS 佇列要求」原則規則項目。

註: 當您在原則規則中選取單位並指定臨界值的值時,請注意精度會隨著單位大小的增加而降低。但如果您發現無法使用較低的單位來指定夠高的值,您可以使用較高(較大)的單位來指定適當的值。例如,如果您要建立儲存體類型原則規則,並想為 64 位元共用儲存體設定大於 4294967295 位元組的臨界值,您無法使用 "B"(位元組)作為單位,但您可以使用 "K" (KB) 作為單位,並在「原則」精靈的欄位中輸入適當的 KB 值,以設定臨界值。
重要: 您可以使用 CICS® 監控資料來設定原則臨界值,但是請注意,由 CICS 監控計算的要求數與 CICS 原則所計算的要求數可能並不相同。這是因為原則只會將 EXEC CICS API 要求納入計數,而監控則會同時納入任何內部要求。因此,任何未通過 EXEC CICS 層的要求都會被 CICS 監控納入計數,但不會納入原則的計數中。以下是使用原則將 WRITEQ TD 要求納入計數的範例:如果使用者作業發出 EXEC CICS SPI 要求來變更 CICS 資源的狀態,使訊息 DFHAP1900 寫入至暫時資料佇列 CADS 中;此要求會被納入 CICS 監控資料計數,但不會納入原則計數中。

範例

此範例列出儲存體及檔案要求原則的 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" 5  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" 5  unit="" 4 />
      <action>
         <message/>  
      </action> 
   </rule> 
</policy:policy>
此範例列出異常終止作業的檔案要求原則的 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" 5  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" 5  unit="K" 4 />
      <action>
         <abend abendCode="CFI1"/>  
      </action> 
   </rule> 
</policy:policy>
此範例列出發出事件的檔案要求原則的 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" 5  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" 5  unit="" 4 />
      <action>
         <event>  
            <eventAdapterSetName>adaSetA</eventAdapterSetName> 
         </event>  
      </action> 
   </rule> 
</policy:policy>
如需如何將表 1 中所顯示的規則類型詳細資料對映至 XML 參數和值的相關資訊,請參閱原則 XML 元素名稱及屬性值