Seuils de règle

Vous pouvez utiliser des règles conditionnelles pour définir différents types de seuils. Lorsque plusieurs règles conditionnelles avec le même seuil sont déployées, l'ordre dans lequel les règles sont déclenchées est le suivant : les règles d'action en premier, puis les règles d'action d'événement, et enfin, les règles d'action à fin anormale.

Détails de type de règle pris en charge

Tableau 1. Détails de type de règle pris en charge
Type de règle  1  Elément de règle  2  Opérateur  3  Unité  4  Valeur  5 

Demande de base de données

Commande SQL

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Demande de fichier

Commande de suppression
Lire la commande
Lire la commande suivante
Lire la commande précédente
Lire la commande de mise à jour
Réécrire la commande
Démarrer la commande de navigation
Ecrire la commande

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Ces plages de valeur pour les demandes ou les milliers de demandes
s'appliquent à tous les éléments de règle conditionnelle de demande de fichier.

Demande de programme

Commande LINK

Remarque : Les commandes INVOKE APPLICATION sont également incluses dans le décompte, mais ne constituent pas une règle distincte.

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Demande de démarrage

Commande START

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Mémoire

Mémoire de tâche 24 bits
Mémoire partagée 24 bits

Mémoire de tâche 31 bits
Mémoire partagée 31 bits

Mémoire de tâche 64 bits
Mémoire partagée 64 bits

Supérieur à

B
octets
K
kilooctets
M
mégaoctets
G
gigaoctets

Eléments de règle 24 bits :

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

Eléments de règle 31 bits :

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

Eléments de règle 64 bits :

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

Demande de mémoire

Demande de mémoire de tâche 24 bits
Demande de mémoire partagée 24 bits

Demande de mémoire de tâche 31 bits
Demande de mémoire partagée 31 bits

Demande de mémoire de tâche 64 bits
Demande de mémoire partagée 64 bits

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Ces plages de valeur pour les demandes ou les milliers de demandes
s'appliquent à tous les éléments de règle conditionnelle de demande de mémoire.

Demande de point de synchronisation

Commande SYNCPOINT

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Demande de file d'attente TD

Commande READQ TD
Commande WRITEQ TD

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Ces plages de valeur pour les demandes ou les milliers de demandes
s'appliquent à tous les éléments de règle conditionnelle de demande de file d'attente TD.

Temps

Temps UC
Temps écoulé

Supérieur à

O
microsecondes
M
millisecondes
S
secondes
O
0 - 4294967295
M
0 - 86400000
S
0 - 86400 (la valeur 86400 équivaut à 24 heures)

Octets de la file d'attente TS

Commande WRITEQ TS
Commande WRITEQ TS auxiliary
Commande WRITEQ TS main

Remarque :
  • L'élément de règle WRITEQ permet de définir un seuil pour la quantité de données écrites dans toutes les files de stockage temporaire (TSQ) combinées. Les autres éléments de règle sont utilisés pour définir un seuil pour un type spécifique de file de stockage temporaire.
  • Les données écrites par les demandes WRITE et REWRITE sont comptées pour le total, et les demandes REWRITE sont traitées comme des opérations WRITE, dans la mesure où le comptage est incrémenté par la taille totale de REWRITE, et non le delta entre les demandes WRITE et REWRITE d'origine.
  • Les données sont comptées uniquement si la demande WRITEQ aboutit.

Supérieur à

B
octets
K
kilooctets
M
mégaoctets
G
gigaoctets
B
0 - 4294967295
K
0 - 4194303
M
0 - 4095
G
0 - 3

Tous les éléments de règle conditionnelle Octets de la file
d'attente TS ont les mêmes plages de valeurs.

Demande de file d'attente TS

Commande READQ TS
Commande WRITEQ TS
Commande WRITEQ TS auxiliary
Commande WRITEQ TS main

Remarque : Les éléments de règle READQ et WRITEQ sont utilisés pour définir un seuil pour le nombre total de demandes READ ou WRITE vers les files de stockage temporaire auxiliaires et principales combinées. Les autres éléments de règle WRITEQ permettent de définir un seuil pour le nombre de demandes WRITE vers un type spécifique de file de stockage temporaire.

Supérieur à

""
demandes
K
mille demandes
""
0 - 4294967295
K
0 - 4294967

Ces plages de valeur pour les demandes ou les milliers de demandes
s'appliquent à tous les éléments de règle conditionnelle de demande de file d'attente TS.

Remarque : Lorsque vous sélectionnez une unité et indiquez une valeur pour le seuil dans votre règle conditionnelle, la granularité diminue au fur et à mesure que l'unité augmente. Cependant, si vous ne pouvez pas spécifier une valeur assez élevée pour l'unité la plus petite, vous pouvez indiquer la valeur appropriée en utilisant une unité supérieure (plus élevée). Par exemple, si vous créez une règle conditionnelle de type de mémoire et que vous souhaitez définir un seuil pour une mémoire partagée 64 bits supérieur à 4294967295 octets, vous ne pouvez pas définir votre seuil en utilisant "B" (Bytes, octets) comme unité, mais vous pouvez le faire en utilisant "K" (Kilooctets) comme unité et en entrant une valeur appropriée en kilooctets dans la zone Valeur de l'assistant Politique.
Important : Vous pouvez utiliser des données de surveillance CICS pour définir un seuil de politique, mais gardez à l'esprit que le nombre de demandes qui sont comptées par la surveillance CICS et celui des demandes qui sont comptées par la politique CICS peuvent différer. En effet, la politique compte uniquement les demandes EXEC CICS API, alors que la surveillance inclut également les demandes internes. Par conséquent, les demandes qui ne passent pas par la couche EXEC CICS sont comptées par la surveillance CICS, mais ne sont pas incluses dans le comptage de la politique. Pour utiliser la politique afin de compter les demandes WRITEQ TD comme exemple, si une tâche utilisateur émet une demande EXEC CICS SPI pour modifier le statut d'une ressource CICS, le message DFHAP1900 est écrit dans la file d'attente de données transitoires CADS. Cette demande est comptée dans les données de surveillance CICS, mais elle n'est pas incluse dans le comptage de la politique.

Exemples

Cet exemple répertorie le code XML pour un stockage et une politique de demande de fichier. La politique émet le message DFHMP3001 lorsqu'une tâche attribue plus de 1 024 octets de mémoire de tâche 24 bits, ou lorsqu'une tâche réalise plus de 50 lectures de fichier.
<?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>
Cet exemple répertorie le code XML pour une politique de demande de fichier qui termine une tâche de façon anormale. La politique termine de façon anormale le code de fin anormale par défaut AMPB si la tâche exécute plus de 10 000 lectures de fichier, ou termine de façon anormale la tâche avec le code de fin anormale spécifié par l'utilisateur CFI1 si la tâche exécute plus de 5 000 écritures de fichier. Avec la fin anormale, le message DFHMP3002 est émis.
<?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>
Cet exemple répertorie le code XML pour une politique de demande de fichier qui émet des événements. La politique émet un événement dans un adaptateur d'événement nommé adapterB si la tâche réalise plus de 500 écritures de fichier, et émet un événement dans un ensemble d'adaptateur d'événement nommé adaSetA si la tâche réalise plus de 100 lectures de fichier.
<?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>
Pour plus d'informations sur la façon dont les détails de type de règle s'affichent dans la mappe du Tableau 1 pour les paramètres et valeurs XML, voir Valeurs d'attribut et nom de l'élément XML de règles.