Steuern des CDC-Prozesses
Data Movement Gateway verwendet ECSA-Speicherstrukturen, die als R4Z CDC-Dienste bezeichnet werden und die während der CDC-Verarbeitung erstellt werden. Jede z/OS LPAR kann mehrere solcher R4Z CDC-Dienste enthalten. Zur Erstellung der R4Z CDC-Dienste wird ein spezielles Dienstprogramm (R4ZCTL) bereitgestellt.
Dieses Programm kann auch verwendet werden, um den Zustand der CDC-Verarbeitung und den Datenverkehr auf z/OS-Seite zu verwalten.
Das R4Z-Steuerprogramm (R4ZCTL) wird für die folgenden Zwecke benötigt: CDC prüfen und den CDC-Dienststatus melden, die CDC-Verarbeitung anhalten, einen angehaltenen CDC-Prozess fortsetzen und den CDC-Prozess beenden, entweder normal oder erzwungen.
Während der Ausführung des R4ZCTL-Programms stehen die folgenden Befehlsparameter zur Verfügung:
Wenn Sie den Befehl ohne Parameter ausführen, wird der aktuelle Status des CDC-Dienstes zurückgegeben.
- CHECKCONFIG : Überprüft, ob die Konfigurationsparameter gültig sind
- PAUSE_TASK: Hält den Dienst einer bestimmten CDC-Aufgabe an
- PAUSE_CDC: Hält die gesamte Aktivität eines CDC-Dienstes an
- RESUME_TASK: Setzt eine angehaltene Aufgabe fort
- RESUME_CDC: Setzt einen angehaltenen CDC-Dienst fort
- TERMINATE : Hält den CDC-Dienst an und gibt danach dessen Ressourcen frei
- FORCE : Wie TERMINATE, wenn die Aufgabe zum Halten von Ressourcen „hängen“
Da für R4ZCTL-Programme APF-Autorisierung erforderlich ist, müssen alle Bibliotheken für STEPLIB APF-autorisiert sein.
Wenn R4ZCTL ohne Parameter ausgeführt wird, wird sein Abschlusscode basierend darauf festgelegt, ob die Umgebung initialisiert (CC=0) oder nicht initialisiert (CC=1) war.
Syntax des Steuerprogrammaufrufs
Das R4ZCTL-Programm wird als Auftragsschritt aufgerufen, z. B. EXEC PGM=R4ZCTL, und akzeptiert Anweisungen über den Aufrufparameter des Auftragsschritts.
Der R4ZCTL-Aufrufparameter ist ein String, der optionale Unterparameter enthalten kann, die wie folgt mit Kommas abgetrennt werden:
[SERVICE=CDC-service-qualifier,][MSGLVL={0 | 1},][action]
Die Reihenfolge der Unterparameter im String hat keine Bedeutung.
Hierbei gilt:
SERVICE=CDC-service-qualifier gibt den logischen Umfang der Data Movement Gateway-Aktivität an, nach dem sich das Steuerprogramm richten soll.
MSGLVL={0 | 1 | 2} gibt die Benachrichtigungsebene an, die in der Nachrichtendatei während der Ausführung des Steuerprogramms angezeigt werden soll.
- 0 = keine Benachrichtigungen
- 1 = Mittel
- 2 = Maximum
action-verb kann eine der folgenden Optionen sein:
-
PAUSE_TASK(*|ALL|task-qualifier)
Setzt den CDC-Abruf für die in Klammern angegebene(n) Aufgabe(n) aus.
-
PAUSE_CDC
Setzt den CDC-Abruf für den ganzen CDC-Dienst aus. Replikationsaufgaben, die für länger als eine bestimmte Zeit ausgesetzt waren, werden angehalten, und es werden mehrere Wiederherstellungsversuche unternommen. Es werden keine neuen Aufgaben gestellt.
-
RESUME_TASK(*|ALL|task-qualifier)
Nimmt den CDC-Abruf für die von task-qualifier angegebene Aufgabe wieder auf.
-
RESUME_CDC
Nimmt den CDC-Abruf für alle Instanzen wieder auf, die dem Qualifizierer session-limits entsprechen.
-
DUMP_TASK(*|ALL|task-qualifier)
Fordert die formatierte Sicherung der Steuerinformationen in residenten Speicherstrukturen an. ALL bezieht sich auf alle Sitzungen, SUMMARYONLY nur auf den Anker.
-
TERMINATE
Gibt alle residenten R4Z-Speicherstrukturen frei, beendet alle aktiven Instanzen und löscht die zugeordneten Ressourcen. Ab diesem Zeitpunkt geben alle CDC-Anforderungen den inaktiven Status zurück, bis der CDC-Dienst durch einen eingehenden Aufruf der CDC-Reader UDF automatisch aktiviert wird.
Syntaxelementreferenz
In den obigen Syntaxbeschreibungen werden folgende Elemente verwendet:
-
CDC-service-qualifier
Ein Name mit 4 Zeichen (erstes Zeichen alphabetisch, Rest alphanumerisch), der einen CDC-Dienst bezeichnet.
„CDC-Dienst“ bezieht sich auf eine Gruppe von Ressourcen – Speicherstrukturen, eine in DB2 definierte benutzerdefinierte Tabellenfunktion (UDTF) und eine in der WLM-Richtlinie definierte Anwendungsumgebung (APPLENV). In R4Z können Sie für jeden CDC-Dienst Eigenschaften wie Speicherlimits und Verarbeitungsschwellenwerte angeben. Es kann auch aus einem anderen Grund erforderlich sein, mehrere CDC-Dienste zu verwalten: wenn mehr als eine Data Movement Gateway-Version, die in einer einzelnen LPAR verwendet wird, bedient werden muss, wobei jede Version unabhängig von den anderen ihre eigenen Speicherstrukturen pflegt.
-
task-qualifier
Ein 4-stelliger Identifikator wird bei Beginn der Aufgabe zugewiesen. Dieser Identifikator dient hauptsächlich dazu, CDC-Datenverkehr einer bestimmten Aufgabe zu steuern und nachzuverfolgen. Er bildet die CORRID (Korrelations-ID) des DB2-Threads, der CDC bedient – dort belegt er die Byte 9-12.
Steuerprogramm-Abschlusscodes
- 0: Normaler Abschluss
- 1: Die Umgebung beendet den Qualifizierer session-limits nicht (wenn keine action angegeben ist)
- 4: Warnung
- 8: Fehler
Beispielaufträge (in der INSTALL-Bibliothek)
IV1CHECK: Prüft die Konfiguration aller CDC-Dienste
XMDUMP: Sichert alle Sitzungen
XMPAUSE: Hält alle Sitzungen an
XMRESUME: Setzt eine Sitzung fort
XMTERMIN: Beendet alle Sitzungen
Aktivieren des CDC-Prozesses (automatische Aktivierung)
Damit die Funktion CDC-Reader-UDTF funktionieren kann, muss sie Speicherstrukturen in ECSA zuweisen und vorformatieren können, wenn die UDTF aufgerufen wird und wenn sie zum ersten Mal nach Start des z/OS-Systems ausgeführt wird. Sie muss auch auf die Konfigurationen zugreifen können, die für den CDC-Dienst, den die UDTF bedient, festgelegt sind (bzw. auf die Standardkonfigurationen für Werte, die auf CDC-Dienstebene nicht angegeben sind).
Um dies zu berücksichtigen, wird beim Installationsprozess Folgendes sichergestellt:
- Eine spezielle UDTF wird erstellt, um den CDC-Dienst zu bedienen. Der Name der erstellten UDTF wird mit einem doppelten Unterstrich angehängt („__“), gefolgt von CDC-service-qualifier. Damit werden Namen wie <schema>.R4Z_UDTF__<CDC-service-qualifier> gebildet.
- Eine WLM APPLENV wird erstellt, um Aufrufe der obigen UDTF auszuführen. An den Namen der erstellten APPLENV kann als Suffix der Qualifizierer des CDC-Diensts angehängt werden, um die Eindeutigkeit des APPLENV-Namens zu gewährleisten. Dies wird empfohlen. Eine APPLENV kann aber von mehreren UDTFs genutzt werden.
- Es wird ein JCL-Verfahren erstellt, um WLM APPLENV-Ausführungen zu hosten. Dieses JCL-Verfahren unterscheidet sich von üblichen WLM STC-Verfahren insoweit, dass ein besonderer DDNAME, R4ZCNFG, angegeben werden muss, dessen DSN auf die CONFIG-Bibliothek des R4Z-Produkts verweist. In dieser Bibliothek MUSS ein Mitglied namens „CDCS“ vorhanden sein, das die Standard-CDC-Dienstkonfigurationen angibt. Es KANN auch ein Mitglied namens „CDCS<CDC-service-qualifier>“ mit den Konfigurationswerten vorhanden sein, die Sie auf diesen CDC-Dienst anwenden möchten.
-
Der Inhalt jedes CDCS*-Mitglieds in der CONFIG-Bibliothek ist eine Liste von Zuweisungsbefehlen, einem pro Karte, im Format „keyword=value“. Der Befehl kann auf Leerzeichen folgen und wird von einem Leerzeichen beendet, aber im Befehl selbst sind keine Leerzeichen zulässig. Karten beginnen mit einem Bindestrich („-“) und werden als Kommentarkarten behandelt. Der Inhalt nach dem Endleerzeichen wird ebenfalls als Kommentar behandelt.
Schlüsselwörter, Höchstwerte, Mindestwerte und Standardwerte Schlüsselwort Beschreibung Minimum Maximum Standard MAXSESSIONS
Die maximale Anzahl an CDC-Sitzungen.
1
128
32
SESSIONTIMEOUTSECS
Die Anzahl der Sekunden, nach denen die Sitzung abläuft.
300
7200
900
MAXIFIBUFKBYTES
Die maximale Puffergröße, die für IFI-Lesevorgänge zulässig ist, in KB.
64
1024
256
MAXRESULTSETMBYTES
Die maximale Größe, die der kumulierte Ergebnissatz erreichen kann, in MB. Wenn sie erreicht ist, wird der Ergebnissatz zurückgegeben.
1
2048
4
MAXRESULTSETSECS
Das maximale Zeitintervall für die Zusammenstellung des Ergebnissatzes, in Sekunden. Wenn es erreicht ist, wird der Ergebnissatz zurückgegeben.
1
120
30
Einrichten von R4Z CDC-Diensten
Entscheidung über die CDC-Dienste: Gestützt auf den voraussichtlichen Bedarf an unabhängigen Replikationsprozessen (um verschiedene Versionen zu ermöglichen, ausreichend ECSA-Speicher sicherzustellen, unterschiedliche zulässige Latenzen zu berücksichtigen usw.) muss entschieden werden, welche R4Z CDC-Dienste in jeder LPAR vorhanden sind. Wählen Sie für jeden Dienst die CDC-Dienstqualifizierer aus (4 Zeichen). Sie müssen auch entscheiden, ob jeder CDC-Dienst seine eigene WLM APPLENV (Anwendungsumgebung) haben soll, oder ob eine einzige APPLENV alle CDC-Dienste bedienen soll.
Sie müssen die Variable DEFWLMAE (WLM-Anwendungsumgebung definieren) im DFSYMLST-Mitglied entweder auf PER (erste Option) oder auf ONE (zweite Option) festlegen. Danach können Sie mit der Installation fortfahren:
Informationshinweis-
Wenn Sie ONE für DEFWLMAE auswählen, werden die Aufträge DO2* und DO3SRVTF ein Mal ausgeführt. Wenn Sie PER auswählen, werden diese Aufträge für jeden CDC-Dienst ausgeführt, nachdem die JCL SET-Variable CDCSRV auf den Qualifizierer des CDC-Diensts festgelegt wurde.
-
Auftrag DO3SRVDF erstellt eine CONFIG-Bibliothek und platziert ein Mitglied namens „CDCS“, das als Standardkonfigurationsdatei dient. Nach dem Ausführen des Auftrags DO3SRVTF enthält die Bibliothek die Konfiguration aller CDC-Dienste, sodass sie bearbeitet und die Konfigurationen eines bestimmten CDC-Dienstes geändert werden können.
-
Wenn ONE für DEFWLMAE verwendet wird, werden die Standardwerte des Produkts anstelle der CONFIG-Bibliotheksmitglieder verwendet.
-