Types de règle conditionnelle

Les types de règle conditionnelle pris en charge sont Requêtes de base de données, Demande de fichier, Demande de programme, Demande de démarrage, Mémoire, Demande de stockage, Demande de point de synchronisation, Heure, Demande de file d'attente TD, Octets de la file d'attente TS et Demande de file d'attente TS.

Demande de base de données

Utilisez le type de règle conditionnelle Demande de base de données pour définir un seuil pour le nombre de requêtes SQL DB2 réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Le comptage comprend les requêtes SQL émises par les sorties. Par exemple, un programme qui émet des requêtes EXEC CICS FILE converties en requêtes SQL par CICS VT compte tout seuil de demande de fichier et tout seuil de comptage SQL.

Demande de fichier

Utilisez le type de règle conditionnelle Demande de fichier pour définir un seuil pour le nombre de demandes d'accès au fichier EXEC CICS réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Le seuil s'applique à une commande de fichier spécifique, par exemple READ. Il ne s'agit pas d'un comptage cumulé de toutes les demandes d'accès à un fichier. Les demandes de fichier sont comptées lorsqu'une application réalise une demande de contrôle de fichier, que la demande ait abouti ou non, y compris lorsqu'un exit utilisateur global XFCREQ renvoie un code de réponse UERCBYP (ignorer la demande). Les demandes sont comptées pour la tâche de la région gérant les applications, que le fichier soit local ou distant. Les demandes ne sont pas comptées dans la région propriétaire de fichier.

Demande de programme

Utilisez le type de règle conditionnelle Demande de programme pour définir un seuil pour le nombre de demandes EXEC CICS LINK ou EXEC CICS INVOKE APPLICATION réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Ce type de règle s'applique aux demandes réalisées localement ou à distance, qu'elles aboutissent ou non, y compris lorsqu'un exit utilisateur global XPCREQ renvoie un code de réponse UERCBYP (ignorer la demande). Toute tâche démarrée dans une région distante qui répond à une demande DPL est donc extérieure à la portée des règles appliquées à la tâche qui a émis la DPL. Ainsi, toute autre demande que la tâche distante peut effectuer n'est pas comptée par la tâche locale.

Remarque : Les demandes EXEC CICS INVOKE APPLICATION sont incluses dans le décompte des demandes EXEC CICS LINK ; elles ne peuvent pas être comptabilisées séparément.

Demande de démarrage

Utilisez le type de règle conditionnelle Demande de démarrage pour définir un seuil pour le nombre de demandes EXEC CICS réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Toutes les demandes EXEC CICS START sont comptées que la demande ait abouti ou non, y compris lorsqu'un exit utilisateur global XICREQ renvoie un code de réponse UERCBYP (ignorer la demande), ou lorsqu'un exit XICERES renvoie un code de réponse UERCPURG (une ressource obligatoire est indisponible).
Remarque : Lorsque vous utilisez une politique sur des demandes EXEC CICS START expédiées par une fonction dans une région distante, le mécanisme de déclenchement dépend du protocole et des paramètres de communication interrégionale. Pour plus d'informations, voir Transaction miroir et programme de transformation dans la documentation du produit CICS TS V5.2.

Mémoire

Utilisez le type de règle conditionnelle Mémoire pour définir un seuil pour la quantité de stockage attribuée par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Le seuil s'applique à une classe de stockage spécifique, par exemple une tâche de stockage 31 bits. Il ne s'agit pas d'un comptage cumulé de toutes les demandes de stockage.

Le comptage de seuil comprend toutes les demandes GETMAIN réalisées avec succès par une tâche utilisateur : les demandes EXEC CICS GETMAIN explicites et les demandes GETMAIN implicites qui se produisent en réponse à d'autres commandes EXEC CICS, par exemple EXEC CICS READ FILE SET. Pour les demandes de mémoire associées à la tâche (task24, task31 et task64), le nombre diminue lorsque la tâche émet une commande FREEMAIN explicite ou implicite qui réussit. Cependant, les comptages de mémoire partagée (shared24, shared31 et shared64) ne diminuent pas lorsqu'une tâche libère de la mémoire partagée.

Important : Si une commande EXEC CICS GETMAIN avec option NOSUSPEND répond à une règle qui indique une action d'événement, la tâche peut être suspendue au cours de la capture des données d'événement.

Demande de mémoire

Utilisez le type de règle conditionnelle Demande de mémoire pour définir un seuil pour le nombre de requêtes GETMAIN réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Ceci diffère du type de règle conditionnelle de stockage, qui est utilisé pour définir des seuils basés sur la quantité de mémoire attribuée. Le comptage de seuil de demande de mémoire comprend toutes les demandes GETMAIN réalisées par une tâche utilisateur : les demandes EXEC CICS GETMAIN explicites et les demandes GETMAIN implicites qui se produisent en réponse à d'autres commandes EXEC CICS, par exemple EXEC CICS READ FILE SET. Le compteur de demandes de mémoire s'incrémente même lorsqu'une demande échoue.

Important : Si une commande EXEC CICS GETMAIN avec option NOSUSPEND répond à une règle qui indique une action d'événement, la tâche peut être suspendue au cours de la capture des données d'événement.

Demande de point de synchronisation

Utilisez le type de règle conditionnelle Demande de point de synchronisation pour définir un seuil pour le nombre de demandes EXEC CICS SYNCPOINT réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Les demandes EXEC CICS SYNCPOINT et SYNCPOINT ROLLBACK sont comptées, et les demandes qui n'ont pas abouti sont incluses en plus des demandes réussies.

Temps

Utilisez le type de règle conditionnelle Temps pour définir un seuil pour la quantité de temps de processeur utilisée par une tâche utilisateur (règle de temps UC), ou le temps pris par une tâche (règle de temps écoulé), et entreprendre l'action automatique si le seuil est dépassé. Le type de règle conditionnelle de temps diffère des autres types de règle conditionnelle, car le seuil est basé sur le temps de processeur, et non sur un comptage de demandes API ou sur la quantité de mémoire attribuée.

Remarque : Pour la règle de temps UC : En raison de la façon dont les changements de processeur sont enregistrés, il n'est pas possible de compter continuellement le temps de processeur. Ainsi, le seuil peut parfois être dépassé avant d'être détecté par cette fonction, et si vous comparez les données de surveillance avec les actions de seuil de politique entreprises, vous pouvez voir des différences. La règle de temps UC compare le temps de processeur total avec la valeur de seuil de la politique. Cependant, la valeur de temps de processeur n'est pas incrémentée, jusqu'à ce qu'une tâche abandonne le contrôle d'un processeur. Ainsi, une tâche peut fortement dépasser un seuil avant d'abandonner le contrôle du processeur et d'autoriser la vérification.

Pour les règles de temps UC, la tâche doit être redistribuée et émettre un appel EXEC CICS ou appelle une valeur TRUE (par exemple un appel EXEC SQL) pour vérifier si le seuil de temps UC est dépassé. Si, pour une raison quelconque, la tâche n'abandonne jamais le contrôle, le traitement RUNAWAY normal termine la tâche de façon anormale si l'intervalle de temps RUNAWAY est dépassé avant tout traitement de politique de temps. Pour les règles de temps écoulé, il est vérifié si le seuil de temps écoulé est dépassé chaque fois qu'une tâche émet un appel EXEC CICS ou appelle une valeur TRUE. Dans les deux cas, si le seuil est dépassé et si l'action associée à la règle se termine de façon anormale, la fin anormale se produit après la fin de la commande.

Demande de file d'attente TD

Utilisez le type de règle conditionnelle Demande de file d'attente TD pour définir un seuil pour le nombre de demandes d'accès à la file d'attente de données transitoires (TDQ) réalisées par une tâche utilisateur, et entreprendre l'action automatique si le seuil est dépassé. Les demandes EXEC CICS READQ TD et EXEC CICS WRITEQ TD sont comptées, et chaque demande est comptée, qu'elle ait abouti ou non, y compris lorsqu'un exit utilisateur global XTDREQ renvoie un code de réponse UERCBYP (ignorer la demande).

Remarque : Un certain nombre d'écritures de produits dans la file d'attente de données transitoires CICS peut entraîner un nombre de demandes plus élevé que ce que vous attendez. Par exemple, Language Environment utilise des données transitoires (TD) EXEC CICS WRITEQ de manière extensive pour écrire des informations de diagnostic, ainsi que pour capturer la sortie d'instructions COBOL display et printf() C. IP CICS Sockets est un autre produit qui utilise des demandes EXEC CICS WRITEQ.

Octets de la file d'attente TS

Utilisez le type de règle conditionnelle Octets de la file d'attente TS pour définir un seuil pour la quantité totale de données écrites vers un type de files de stockage temporaire (auxiliaire ou principale), ou la quantité totale de données écrites dans les files de stockage temporaire auxiliaires et principales combinées, et entreprendre l'action automatique si le seuil est dépassé. Seules les données provenant de demandes ayant abouti sont comptées. Les données écrites par les demandes EXEC CICS WRITEQ TS et EXEC CICS WRITEQ TS REWRITE sont comptées pour le total. Pour les demandes EXEC CICS WRITEQ TS REWRITE, le comptage est incrémenté par la taille totale de REWRITE, et non le delta entre les demandes WRITE et REWRITE d'origine. Ce comportement est cohérent avec la manière dont le domaine MN traite les demandes TSQ WRITE et REWRITE.

Demande de file d'attente TS

Utilisez le type de règle conditionnelle Demande de file d'attente TS pour définir un seuil pour le nombre de demandes EXEC CICS READQ TS et EXEC CICS WRITEQ TS émises par une tâche utilisateur vers des files de stockage temporaire auxiliaires ou principales ou vers toutes les files de stockage temporaire auxiliaires et principales combinées, et entreprendre l'action automatique si le seuil est dépassé. Les demandes de lecture ou d'écriture vers les files de stockage temporaire partagées locales NE sont PAS comptées. Toutes les demandes d'accès à des files de stockage temporaire auxiliaires ou principales sont comptées qu'elles aboutissent ou non, y compris lorsqu'un exit utilisateur global XTSEREQ renvoie un code de réponse UERCBYP (ignorer la demande). Les demandes EXEC CICS WRITEQ TS REWRITE sont comptées comme des demandes WRITEQ.

Remarque : Les points suivants s'appliquent aux types de règle conditionnelle Octets de la file d'attente TS et Demande de file d'attente TS :
  • Pour les demandes de file de stockage temporaire éloignée, seuls les comptages READQ TS et WRITEQ TS agrégés sont mis à jour, mais cela inclura les demandes de file de stockage temporaire partagée. Comme le type de file de stockage temporaire pour une demande distante n'est pas connu dans la région gérant les applications, les comptages pour des types de file d'attente spécifiques ne sont pas mis à jour. Les demandes de file de stockage temporaire émises par des programmes qui sont appelés par un accès aux programmes répartis (DPL) ou des tâches démarrées par un routage de transactions sont comptées dans le système (région gérant les applications) distant uniquement.
  • Les demandes de file de stockage temporaire émises par le code système CICS en tant que résultat indirect d'un événement déclenché par une tâche utilisateur CICS peuvent ne pas être comptées. Par exemple, l'adaptateur d'événements de stockage temporaire DFHECEAT émet des demandes de file de stockage temporaire si une tâche utilisateur déclenche un événement CICS. Si l'événement est défini comme étant synchrone, ces demandes sont émises sous la tâche (utilisateur) de capture et sont comptées par code de politique. Si l'événement est asynchrone, les demandes de file de stockage temporaire sont émises sous une tâche système CICS (et une tâche sont le programme d'initialisation démarre DFH) pour qu'une politique ne s'applique pas à cette tâche, et elles ne sont pas comptées.
  • Les demandes de file de stockage temporaire émises par CICS qui ne passent pas par le programme d'interface CICS EXEC (DFHEIP) sont comptées par surveillance, mais pas par le code de politique.
Pour plus d'informations sur les seuils associés aux types de règle conditionnelle, voir Seuils de règle.