Richtliniengrenzwerte

Sie können Richtlinienregeln verwenden, um mehrere unterschiedliche Typen von Grenzwerten zu definieren. Wenn mehrere Richtlinienregeln mit dem gleichen Grenzwert implementiert werden, werden die Regeln in der folgenden Reihenfolge ausgelöst: Nachrichtenaktionsregeln, Ereignisaktionsregeln und zuletzt Abbruchaktionsregeln.

Unterstützte Regeltypdetails

Tabelle 1. Unterstützte Regeltypdetails
Regeltyp  1  Regelelement  2  Operator  3  Einheit  4  Wert  5 

Datenbankanforderung

SQL-Befehl

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Dateianforderung

Befehl DELETE
Befehl READ
Befehl READ NEXT
Befehl READ PREVIOUS
Befehl READ UPDATE
Befehl REWRITE
Befehl START BROWSE
Befehl WRITE

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Diese Wertebereiche für Anforderungen oder tausend Anforderungen gelten für alle Elemente des Richtlinienregeltyps "Dateianforderung".

Programmanforderung

Befehl LINK

Anmerkung: INVOKE APPLICATION-Befehle werden ebenfalls in die Zählung einbezogen, stellen jedoch kein separates Richtlinienelement dar.

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Startanforderung

Befehl START

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Speicher

24-Bit-Taskspeicher
Gemeinsam genutzter 24-Bit-Speicher

31-Bit-Taskspeicher
Gemeinsam genutzter 31-Bit-Speicher

64-Bit-Taskspeicher
Gemeinsam genutzter 64-Bit-Speicher

Ist größer als

B
Byte
K
Kilobyte
M
Megabyte
G
Gigabyte

24-Bit-Regelelemente:

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

31-Bit-Regelelemente:

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

64-Bit-Regelelemente:

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

Speicheranforderung

Anforderung von Taskspeicher mit 24 Bit
Anforderung von gemeinsam genutztem Speicher mit 24 Bit

Anforderung von Taskspeicher mit 31 Bit
Anforderung von gemeinsam genutztem Speicher mit 31 Bit

Anforderung von Taskspeicher mit 64 Bit
Anforderung von gemeinsam genutztem Speicher mit 64 Bit

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Diese Wertebereiche für Anforderungen oder tausend Anforderungen gelten für alle Elemente des Richtlinienregeltyps "Speicheranforderung".

Synchronisationspunktanforderung

Befehl SYNCPOINT

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

TD-Warteschlangenanforderung

Befehl READQ TD
Befehl WRITEQ TD

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Diese Wertebereiche für Anforderungen oder tausend Anforderungen gelten für alle Elemente des Richtlinienregeltyps "TD-Warteschlangenanforderung".

Zeit

CPU-Zeit
Abgelaufene Zeit

Ist größer als

O
Mikrosekunden
M
Millisekunden
S
Sekunden
O
0 - 4294967295
M
0 - 86400000
S
0 - 86400 (der Wert 86400 entspricht 24 Stunden)

TS-Warteschlange (Bytes)

Befehl WRITEQ TS
Befehl WRITEQ TS auxiliary
Befehl WRITEQ TS main

Anmerkung:
  • Das Richtlinienelement WRITEQ wird verwendet, um einen Grenzwert für das Datenvolumen festzulegen, das in alle TSQs (Warteschlangen für temporären Speicher) zusammen geschrieben wird. Die anderen Richtlinienelemente werden verwendet, um einen Grenzwert für TSQs eines bestimmten Typs festzulegen.
  • In die Summe fließen die Daten ein, die durch WRITE- und REWRITE-Anforderungen geschrieben werden. Dabei werden REWRITE-Anforderungen wie WRITE-Operationen behandelt, das heißt, die Anzahl erhöht sich um die Gesamtgröße des REWRITE, also nicht um die Differenz zwischen dem ursprünglichen WRITE und dem REWRITE.
  • Die Daten werden nur dann gezählt, wenn das WRITEQ erfolgreich ausgeführt wurde.

Ist größer als

B
Byte
K
Kilobyte
M
Megabyte
G
Gigabyte
B
0 - 4294967295
K
0 - 4194303
M
0 - 4095
G
0 - 3

Für alle Elemente des Richtlinienregeltyps "TS-Warteschlange (Bytes)" gelten dieselben Wertebereiche.

TS-Warteschlangenanforderung

Befehl READQ TS
Befehl WRITEQ TS
Befehl WRITEQ TS auxiliary
Befehl WRITEQ TS main

Anmerkung: Die Richtlinienelemente READQ und WRITEQ werden verwendet, um einen Grenzwert für die Gesamtzahl READ- oder WRITE-Anforderungen an alle Warteschlangen für temporären Hilfsspeicher und Warteschlangen für temporären Hauptspeicher zusammen festzulegen. Die anderen WRITEQ-Richtlinienelemente werden verwendet, um einen Grenzwert für die Anzahl WRITE-Anforderungen an Warteschlangen eines bestimmten Typs festzulegen.

Ist größer als

""
Anforderungen
K
Tausend Anforderungen
""
0 - 4294967295
K
0 - 4294967

Diese Wertebereiche für Anforderungen oder tausend Anforderungen gelten für alle Elemente des Richtlinienregeltyps "TS-Warteschlangenanforderung".

Anmerkung: Wenn Sie eine Einheit auswählen und einen Grenzwert in Ihrer Richtlinienregel angeben, beachten Sie, dass sich die Granularität vermindert, wenn die Größe der Einheit zunimmt. Wenn Sie jedoch keinen ausreichend hohen Wert bei der niedrigen Einheit angeben können, sollten Sie versuchen, einen geeigneten Wert anzugeben, indem Sie eine höhere (größere) Einheit verwenden. Beispiel: Wenn Sie eine Richtlinienregel des Typs "Speicher" erstellen und für den gemeinsam genutzten 64-Bit-Speicher einen Grenzwert größer als 4294967295 Byte festlegen möchten, können Sie nicht die Einheit "B" (Byte) verwenden. Sie können aber vielleicht Ihren Grenzwert mit der Einheit "K" (Kilobyte) festlegen, indem Sie den entsprechenden Wert für Kilobyte im Feld Wert im Richtlinienassistenten eingeben.
Wichtig: Sie können CICS-Überwachungsdaten verwenden, um einen Richtliniengrenzwert festzulegen, müssen aber immer berücksichtigen, dass sich die Zahl der Anforderungen, die durch die CICS-Überwachung gezählt werden, und die Anzahl der Anforderungen, die durch die CICS-Richtlinie gezählt werden, unterscheiden könnten. Dies liegt daran, dass die Richtlinie nur EXEC CICS-API-Anforderungen zählt, während die Überwachung auch alle internen Anforderungen berücksichtigt. Deshalb werden die Anforderungen, die die EXEC CICS-Schicht nicht durchlaufen, durch die CICS-Überwachung, aber nicht durch die Richtlinie gezählt. Beispiel für die Verwendung der Richtlinie zum Zählen von WRITEQ TD-Anforderungen: Wenn eine Benutzertask eine EXEC CICS-SPI-Anforderung zum Ändern des Status einer CICS-Ressource ausgibt, wird die Nachricht DFHAP1900 in die Warteschlange mit transienten Daten CADS geschrieben. Diese Anforderung wird in den CICS-Überwachungsdaten, aber nicht durch die Richtlinie gezählt.

Beispiele

In diesem Beispiel ist die XML-Komponente für eine Richtlinie vom Typ "Speicher" und eine Richtlinie vom Typ "Dateianforderung" aufgeführt. Von der Richtlinie wird die Nachricht DFHMP3001 ausgegeben, wenn eine Task mehr als 1024 Byte des 24-Bit-Taskspeichers zuordnet oder wenn eine Task mehr als 50 Dateileseoperationen ausführt.
<?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>
In diesem Beispiel wird die XML-Komponente für eine Richtlinie vom Typ "Dateianforderung" aufgelistet, mit der eine Task abgebrochen wird. Die Richtlinie bricht die Task mit dem Standardabbruchcode AMPB ab, wenn die Task mehr als 10000 Dateileseoperationen ausführt. Die Task wird mit dem benutzerdefinierten Abbruchcode CFI1 abgebrochen, wenn sie mehr als 5000 Dateischreiboperationen ausführt. Für den Abbruch wird die Nachricht DFHMP3002 ausgegeben.
<?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>
In diesem Beispiel wird die XML-Komponente für eine Richtlinie vom Typ "Dateianforderung" aufgelistet, mit der Ereignisse ausgegeben werden. Die Richtlinie gibt ein Ereignis an einen Ereignisadapter mit dem Namen "adapterB" aus, wenn die Task mehr als 500 Dateischreiboperationen ausführt. Sie gibt ein Ereignis an eine Ereignisadaptergruppe mit dem Namen "adaSetA" aus, wenn die Task mehr als 100 Dateileseoperationen ausführt.
<?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>
Weitere Informationen zu der Art und Weise, in der die Regeltypdetails, die in Tabelle 1 dargestellt werden, den XML-Parametern und -Werten zugeordnet werden, finden Sie unter Name und Attributwerte der XML-Elemente für die Richtlinie.