Richtlinienregeltypen

Die unterstützten Richtlinienregeltypen sind "Datenbankanforderung", "Dateianforderung", "Programmanforderung", "Startanforderung", "Speicher", "Speicheranforderung", "Synchronisationspunktanforderung", "Uhrzeit", "Anforderung in der Warteschlange mit transienten Daten", "Bytes in der TS-Warteschlange" und "Anforderung in der Warteschlange für temporären Speicher".

Datenbankanforderung

Verwenden Sie den Richtlinienregeltyp "Datenbankanforderung", um einen Grenzwert für die Anzahl der DB2-SQL-Anforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Der Zähler bezieht SQL-Anforderungen ein, die von Exits ausgegeben wurden. Beispiel: Ein Programm, das EXEC CICS FILE-Anforderungen ausgibt, die von CICS VT in SQL-Anforderungen konvertiert werden, dokumentiert die Zählung für jeden Dateianforderungsgrenzwert und jeden Grenzwert für SQL-Zähler.

Dateianforderung

Verwenden Sie den Richtlinienregeltyp "Dateianforderung", um einen Grenzwert für die Anzahl der EXEC CICS-Dateizugriffsanforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Der Grenzwert gilt für einen speziellen Dateibefehl, z. B. READ. Hierbei handelt es sich nicht um eine kumulative Anzahl aller Dateizugriffsanforderungen. Dateianforderungen werden gezählt, wenn eine Anwendung eine Dateisteuerungsanforderung sendet. Dabei spielt es keine Rolle, ob die Anforderung erfolgreich ausgeführt wird oder nicht. Gezählt wird auch, wenn der globale Benutzerexit XFCREQ den Antwortcode UERCBYP (Anforderung ignorieren) zurückgibt. Die Anforderungen werden unter der Task für die AOR (Application-Owning Region) gezählt. Dies gilt für lokale und auch für ferne Dateien. Anforderungen werden in der FOR (File-Owning Region) nicht gezählt.

Programmanforderung

Verwenden Sie den Richtlinienregeltyp "Programmanforderung", um einen Grenzwert für die Anzahl der EXEC CICS LINK- oder EXEC CICS INVOKE APPLICATION-Anforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Dieser Regeltyp gilt für Anforderungen, die lokal oder fern verarbeitet werden. Dabei spielt es keine Rolle, ob die Anforderung erfolgreich ausgeführt wird oder nicht. Gezählt wird auch, wenn der globale Benutzerexit XFCREQ den Antwortcode UERCBYP (Anforderung ignorieren) zurückgibt. Jede Task, die in einer fernen Region gestartet wird, die eine DPL-Anforderung verarbeitet, liegt dann außerhalb des Bereichs der Regeln, die auf die Task angewendet werden, die den DPL ausgegeben hat. Alle weiteren Anforderungen, die die ferne Task möglicherweise ausführt, werden dann von der lokalen Task nicht gezählt.

Anmerkung: EXEC CICS INVOKE APPLICATION-Anforderungen werden in die Zählung für EXEC CICS LINK-Anforderungen einbezogen. Sie können nicht separat gezählt werden.

Startanforderung

Verwenden Sie den Richtlinienregeltyp "Startanforderung", um einen Grenzwert für die Anzahl der EXEC CICS START-Anforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Gezählt werden alle EXEC CICS START-Anforderungen. Dabei spielt es keine Rolle, ob die Anforderung erfolgreich ausgeführt wird oder nicht. Gezählt wird auch, wenn der globale Benutzerexit XICREQ den Antwortcode UERCBYP (Anforderung ignorieren) zurückgibt oder wenn der Exit XICERES den Antwortcode UERCPURG (eine erforderliche Ressource ist nicht verfügbar) zurückgibt.
Anmerkung: Wenn Sie in ausgelieferten EXEC CICS START-Anforderungen der Funktion eine Richtlinie in einer fernen Region verwenden, hängt der Auslösermechanismus von dem Protokoll und den Einstellungen der regionsübergreifenden Kommunikation ab. Weitere Informationen finden Sie im Abschnitt Das Spiegeltransaktions- und Transformerprogramm in der Produktdokumentation zu CICS TS V5.2.

Speicher

Verwenden Sie den Richtlinienregeltyp "Speicher", um einen Grenzwert für die Menge an Speicherplatz, die von einer Benutzertask zugeordnet wird, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Der Grenzwert gilt für eine spezielle Speicherklasse, z. B. den 31-Bit-Taskspeicher. Hierbei handelt es sich nicht um eine kumulative Anzahl aller Speicheranforderungen.

Der Grenzwertzähler umfasst alle erfolgreich von einer Benutzertask ausgeführten GETMAIN-Anforderungen, sowohl explizite EXEC CICS GETMAIN-Anforderungen als auch implizite GETMAIN-Anforderungen, die als Antwort auf andere EXEC CICS-Befehle auftreten, beispielsweise EXEC CICS READ FILE SET. Bei taskbezogenen Speicheranforderungen (task24, task31 und task64) wird die Anzahl reduziert, wenn die Task erfolgreich eine explizite oder implizite FREEMAIN-Anforderung ausgibt. Die Zähler für den gemeinsam genutzten Speicher (shared24, shared31 und shared64) werden hingegen NICHT reduziert, wenn eine Task gemeinsam genutzten Speicher freigibt.

Wichtig: Wenn ein EXEC CICS GETMAIN-Befehl mit der Option NOSUSPEND eine Regel erfüllt, in der eine Aktion für das Ereignis angegeben wird, wird die Task möglicherweise während der Erfassung der Ereignisdaten ausgesetzt.

Speicheranforderung

Verwenden Sie den Richtlinienregeltyp "Speicheranforderung", um einen Grenzwert für die Anzahl der GETMAIN-Anforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Dieser Typ unterscheidet sich vom Richtlinienregeltyp "Speicher", der zum Definieren von Grenzwerten dient, die auf der Menge an zugeordnetem Speicher basieren. Der Grenzwertzähler für die Speicheranforderung umfasst alle GETMAIN-Anforderungen, die von einer Benutzertask ausgeführt werden können. Dies sind explizite EXEC CICS GETMAIN-Anforderungen und implizite GETMAIN-Anforderungen, die in Beantwortung anderer EXEC CICS-Befehle (z. B. EXEC CICS READ FILE SET) ausgeführt werden. Der Speicheranforderungszähler wird auch dann erhöht, wenn eine Anforderung fehlschlägt.

Wichtig: Wenn ein EXEC CICS GETMAIN-Befehl mit der Option NOSUSPEND eine Regel erfüllt, in der eine Aktion für das Ereignis angegeben wird, wird die Task möglicherweise während der Erfassung der Ereignisdaten ausgesetzt.

Synchronisationspunktanforderung

Verwenden Sie den Richtlinienregeltyp "Synchronisationspunktanforderung", um einen Grenzwert für die Anzahl der EXEC CICS SYNCPOINT-Anforderungen, die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Gezählt werden sowohl EXEC CICS SYNCPOINT- als auch SYNCPOINT ROLLBACK-Anforderungen und neben den erfolgreichen Anforderungen werden auch die nicht erfolgreichen Anforderungen berücksichtigt.

Zeit

Verwenden Sie den Richtlinienregeltyp "Zeit", um einen Grenzwert für die Menge an Prozessorzeit, die von einer Benutzertask verwendet werden kann (Richtlinienelement "CPU-Zeit") oder für die mögliche Dauer einer Task (Richtlinienelement "Abgelaufene Zeit") und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Der Richtlinienregeltyp "Zeit" unterscheidet sich von den anderen Richtlinienregeltypen dahingehend, dass der Grenzwert auf der Zeit basiert und nicht auf der Anzahl der API-Anforderungen oder der Menge des zugeordneten Speichers.

Anmerkung: Richtlinienelement "CPU-Zeit": Aufgrund der Art und Weise, in der Prozessoränderungen aufgezeichnet werden, kann die Prozessorzeit nicht kontinuierlich gemessen werden. Wenn der Grenzwert also überschritten wird, bevor diese Situation von der Funktion erkannt wird, und wenn Sie Überwachungsdaten mit den auszuführenden Richtliniengrenzwertaktionen vergleichen müssen, dann werden Sie möglicherweise Abweichungen feststellen. Das Richtlinienelement "CPU-Zeit" vergleicht die gesamte Prozessorzeit mit dem Richtliniengrenzwert. Der Wert für die Prozessorzeit wird allerdings erst dann erhöht, wenn eine Task die Steuerung eines Prozessors aufgibt, sodass eine Task einen Grenzwert erheblich überschreiten kann, bevor sie die Steuerung des Prozessors aufgibt und somit eine Überprüfung ermöglicht.

Beim Richtlinienelement "CPU-Zeit" muss die Task erst erneut zugeteilt werden und den nächsten EXEC CICS-Aufruf oder einen TRUE-Aufruf (z. B. einen Aufruf für EXEC SQL) absetzen, bevor geprüft wird, ob der Grenzwert für die CPU-Zeit überschritten wurde. Wenn die Task aus bestimmten Gründen die Steuerung niemals abgibt, wird vor der Verarbeitung der Richtlinie "Zeit" die Task über die normale RUNAWAY-Verarbeitung abgebrochen, wenn das RUNAWAY-Zeitintervall überschritten wird. Beim Richtlinienelement "Abgelaufene Zeit" wird bei jedem EXEC CICS-Aufruf oder TRUE-Aufruf der Task überprüft, ob der Schwellenwert für die abgelaufene Zeit überschritten ist. In beiden Fällen wird, wenn der Grenzwert überschritten wird und die Regelaktion einen Abbruch bedeutet, der Abbruch nach Ausführung des Befehls durchgeführt.

TD-Warteschlangenanforderung

Verwenden Sie den Richtlinienregeltyp "TD-Warteschlangenanforderung", um einen Grenzwert für die Anzahl der TDQ-Zugriffsanforderungen (TDQ = Warteschlange mit transienten Daten), die von einer Benutzertask ausgeführt werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Gezählt werden alle EXEC CICS READQ TD- und EXEC CICS WRITEQ TD-Anforderungen. Dabei spielt es keine Rolle, ob die Anforderung erfolgreich ausgeführt wird oder nicht. Gezählt wird auch, wenn der globale Benutzerexit XTDREQ den Antwortcode UERCBYP (Anforderung ignorieren) zurückgibt.

Anmerkung: Einige Produkte schreiben in die CICS-TDQ. Dies führt möglicherweise zu einer höheren Anzahl an Anforderungen als erwartet. Language Environment verwendet zum Beispiel häufig EXEC CICS WRITEQ TD, um Diagnoseinformationen zu schreiben, und um die Ausgabe der display-Anweisung aus Cobol sowie der printf()-Anweisung aus C zu erfassen. IP CICS Sockets ist ein weiteres Produkt, das die EXEC CICS WRITEQ-Anforderungen verwendet.

TS-Warteschlange (Bytes)

Verwenden Sie den Richtlinienregeltyp "TS-Warteschlange (Bytes)", um einen Grenzwert für die Gesamtmenge an Daten, die durch eine Benutzertask in eine Warteschlange für temporären Speicher (TSQ) eines bestimmten Typs (entweder temporärer Hilfsspeicher oder temporärer Hauptspeicher) oder in die Warteschlangen für temporären Speicher (Temporary Storage Queues, TSQs) dieser beiden Typen zusammen geschrieben werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Gezählt werden nur die Daten von erfolgreichen Anforderungen. In die Summe fließen die Daten ein, die durch EXEC CICS WRITEQ TS- und EXEC CICS WRITEQ TS REWRITE-Anforderungen geschrieben werden. Bei EXEC CICS WRITEQ TS REWRITE-Anforderungen erhöht sich die Anzahl um die Gesamtgröße des REWRITE, also nicht um die Differenz zwischen dem ursprünglichen WRITE und dem REWRITE. Dieses Verhalten entspricht der Art und Weise, in der MN Domain die Anforderungen TSQ WRITE und REWRITE behandelt.

TS-Warteschlangenanforderung

Verwenden Sie den Richtlinienregeltyp "TS-Warteschlangenanforderung", um einen Grenzwert für die Anzahl der EXEC CICS READQ TS- und EXEC CICS WRITEQ TS-Anforderungen, die von einer Benutzertask an Warteschlangen für temporären Hilfsspeicher oder Warteschlangen für temporären Hauptspeicher oder an alle Warteschlangen für temporären Speicher (Temporary Storage Queues, TSQs) dieser beiden Typen zusammen ausgegeben werden können, und die Ausführung einer automatischen Aktion zu definieren, wenn der Grenzwert überschritten wird. Anforderungen zum Lesen oder Schreiben in lokalen gemeinsam genutzten Warteschlangen für temporären Speicher werden NICHT gezählt. Gezählt werden alle TSQ-Zugriffsanforderungen auf Warteschlangen für temporären Hauptspeicher und Warteschlangen für temporären Hilfsspeicher. Dabei spielt es keine Rolle, ob die Anforderung erfolgreich ausgeführt wird oder nicht. Gezählt wird auch, wenn der globale Benutzerexit XTSEREQ den Antwortcode UERCBYP (Anforderung ignorieren) zurückgibt. EXEC CICS WRITEQ TS REWRITE-Anforderungen werden als WRITEQ gezählt.

Anmerkung: Die folgenden Punkte gelten für die Richtlinienregeltypen "TS-Warteschlange (Bytes)" und "TS-Warteschlangenanforderung":
  • Bei Anforderungen an ferne TSQs wird nur die zusammengefasste Anzahl von READQ TS und WRITEQ TS aktualisiert, Anforderungen an gemeinsam genutzte TSQs werden dabei jedoch nicht berücksichtigt. Da der TSQ-Typ für eine ferne Anforderung in der AOR unbekannt ist, werden die Zähler für bestimmte Warteschlangentypen nicht aktualisiert. TSQ-Anforderungen, die von durch Verbindungen zu verteilten Programmen (Distributed Program Link, DPL) aufgerufene Programme oder von durch Transaktionsrouting gestartete Tasks aufgerufen wurden, werden nur im fernen System (AOR) gezählt.
  • Gezählt werden könnten auch TSQ-Anforderungen, die von CICS-Systemcode als indirektes Ergebnis eines durch eine CICS-Benutzertask ausgelösten Ereignisses ausgegeben wurde. Zum Beispiel gibt der TS-Ereignisadapter DFHECEAT (TS = Temporary Storage, temporärer Speicher) TSQ-Anforderungen aus, wenn eine Benutzertask ein CICS-Ereignis auslöst. Wenn das Ereignis als synchron definiert wurde, dann werden diese Anforderungen unter der Erfassungs(benutzer)task ausgegeben und nach Richtliniencode gezählt. Wenn das Ereignis als synchron definiert wurde, dann werden die TSQ-Anforderungen unter einer CICS-Systemtask (und einer Task, deren Startprogramm DFH startet) ausgegeben und nicht gezählt, da in diesem Fall keine Regel für diese Task gilt.
  • Von CICS ausgegebene TSQ-Anforderungen, die das CICS EXEC-Schnittstellenprogramm (DFHEIP) nicht durchlaufen, werden nach Überwachungscode, aber nicht nach Richtliniencode gezählt.
Weitere Informationen zu den Grenzwerten, die den Richtlinienregeltypen zugeordnet sind, finden Sie in Richtliniengrenzwerte.