CHGDMTVAL - Zielsystemparameter festlegen

Mit diesem Befehl können Sie Subskribentensystemparameter über die Befehlszeile festlegen.

Systemparameter können auch in Management Consolefestgelegt werden. Weitere Informationen zum Arbeiten mit Systemparametern finden Sie unter Systemparameter für IBM® CDC für Db2® for i

Gilt für-Ziel

Parameter

Tabelle 1. Unterstützte Schlüsselwörter
Schlüsselwort	Beschreibung	Optionen	Hinweise
NOTIFYQ	Name der Nachrichtenwarteschlange	`Qualifizierter Objektname`	Optionale
	Qualifikationsmerkmal 1: Name der Nachrichtenwarteschlange	*SAME, `Name`
	Qualifikationsmerkmal 2: Bibliothek	LIBL, `Name`, CURLIB, *SAME
NOTIFYCNT	Fehleranzahl	*SAME, `Anzahl`	Optionale
AUTCDE	Autorisierungscode	*SAME, `Code`	Optionale
Aktualisieren	Bei Fehler beenden	GLEICH, NEIN, *JA	Optionale
SPIEGELN	Bei Fehler beenden	GLEICH, NEIN, *JA	Optionale
SPALTE	Spaltenwertprüfung	GLEICH, NEIN, *JA	Optionale
NUMCOLMSG	Nachrichtengenerierungsformat	GLEICH, NB, NEIN, JA	Optionale
CMTCTRL	Commitsteuerung	SAME, LEVEL1, *NONE	Optionale
MSGNOTNULL	Nachrichtengenerierungsstatus	GLEICH, NEIN, *JA	Optionale
DFTDATUM	Datumsformat	GLEICH, NEU, *ALT	Optionale
MONSAMPFRQ	Aktualisierungsintervall für Latenzmetriken	5, `Zeit`	Optionale
Systemstart	Wartezeit für die Beendigung des Initialisierungsprozesses	120, `Zeit`	Optionale
Fortschritt	Statusnachricht	0, `Zeit`	Optionale
LCKTIMEOUT	Zeitlimit für Sperre	30, `Zeit`	Optionale
RCDFMTCHK	Datensatzformatprüfung	GLEICH, JA, *NEIN	Optionale
DBPROZENT	Prozentwert für die Totzone	3, `Anzahl`	Optionale
BKMKTRACE	Lesezeichentraces zulassen	NEIN, JA	Optionale

Name der Nachrichtenwarteschlange (NOTIFYQ)

Der Name der Nachrichtenwarteschlange, an die Benachrichtigungen gesendet werden, wenn die Anzahl der von CDC Replication erkannten Fehler den Schwellenwert für Hinweisnachrichten überschreitet.

Qualifikationsmerkmal 1: Name der Nachrichtenwarteschlange

Name: Der Name der Nachrichtenwarteschlange.; Der Name der Bibliothek, in der sich die Nachrichtenwarteschlange befindet, muss dem Namen der Nachrichtenwarteschlange vorangestellt sein.
*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.

Qualifikationsmerkmal 2: Bibliothek

Name: Der Name der Bibliothek, in der sich die Nachrichtenwarteschlange befindet.; Der Name der Bibliothek, in der sich die Nachrichtenwarteschlange befindet, muss dem Namen der Nachrichtenwarteschlange vorangestellt sein.
*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.
*LIBL: Gibt die Bibliothekengruppe in Ihrer Bibliotheksliste an. Die Bibliotheken werden in der Reihenfolge nach dem ersten Vorkommen der angegebenen Nachrichtenwarteschlange durchsucht.; Dies ist die Standardeinstellung.
*CURLIB: Gibt die aktuelle Bibliothek an.

Fehleranzahl (NOTIFYCNT)

Die Anzahl der Fehler, die CDC Replication generiert, bevor eine Benachrichtigung an die Benachrichtigungsnachrichtenwarteschlange gesendet wird.

Anzahl: Die Anzahl Fehler.; Mindesteinstellung: 1 Fehler; Höchsteinstellung: 99999 Fehler
*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet.; Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.; Dies ist die Standardeinstellung.

Berechtigungscode (AUTCDE)

Der von IBMausgegebene Berechtigungscode. Anpassungen am Berechtigungscode sind erforderlich, wenn Sie von einer temporären Lizenz zu einer permanenten Lizenz wechseln, wenn Maschinenklassen geändert wurden oder wenn Sie CDC Replication auf eine neue Version aktualisieren.

Code: Der Autorisierungscode.
*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.

Bei Fehler beenden (REFRESH)

Gibt an, ob CDC Replication eine Datenaktualisierung beendet, wenn ein Fehler auftritt.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: Gibt an, dass CDC Replication eine Aktualisierung sofort nach dem Erkennen eines Fehlers beendet.; Sie sollten diesen Parameter auf *YES einstellen, es sei denn, es spricht ein bestimmter Grund dagegen.
*NEIN: Gibt an, dass CDC Replication den Fehler meldet und die Aktualisierung fortsetzt, nachdem der Fehler festgestellt wurde.

Bei Fehler beenden (MIRROR)

Gibt an, ob CDC Replication die Spiegelung beendet, wenn ein Fehler auftritt.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: Gibt an, dass CDC Replication die Spiegelung sofort nach dem Erkennen eines Fehlers beendet.
*NEIN: Gibt an, dass CDC Replication den Fehler meldet und die Spiegelung fortsetzt, nachdem der Fehler festgestellt wurde.; Sie sollten diesen Parameter auf *NO einstellen, es sei denn, es spricht ein bestimmter Grund dagegen.

Spaltenwertprüfung (COLUMNVAL)

Gibt an, ob CDC Replication Dezimalspalten und numerische Spalten auf gültige Formate überprüfen soll, bevor die numerischen Daten auf die Zieltabelle angewendet werden

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: Gibt an, dass die Daten in jedem gepackten und gezonten Feld geprüft werden sollen, bevor sie auf die Zieltabelle angewendet werden.; Wenn ungültige gepackte/gezonte Daten gefunden werden, wird eine Nachricht generiert und das Feld wird automatisch auf 0 gesetzt.
*NEIN: Gibt an, dass die Daten in jedem gepackten und gezonten Feld nicht geprüft werden sollen, bevor sie auf die Zieltabelle angewendet werden.; Wenn Sie sicher sind, dass numerische Daten nicht geprüft werden müssen, setzen Sie diesen Parameter auf *NO, um bestehende Leistungsstufen aufrechtzuerhalten.

Nachrichtengenerierungsformat (NUMCOLMSG)

Gibt an, wie CDC Replication Nachrichten generiert, wenn ungültige numerische Daten erkannt werden. CDC Replication kann ungültige numerische Daten auf dem Subskriptionsserver in null konvertieren.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: Gibt an, dass für jedes ungültige numerische Feld, das erkannt wurde, eine Nachricht generiert werden soll.
*NEIN: Gibt an, dass für ungültige numerische Felder, die erkannt werden, keine Nachricht generiert werden soll.; Wenn Sie sicher sind, dass numerische Daten nicht geprüft werden müssen, setzen Sie diesen Parameter auf *NO, um bestehende Leistungsstufen aufrechtzuerhalten.
*NB: Gibt an, dass keine Nachrichten gesendet werden, wenn leere oder nicht initialisierte numerische Felder erkannt werden. Nachrichten für andere Typen ungültiger numerischer Daten werden jedoch generiert.

Commitsteuerung (CMTCTRL)

Gibt die Stufe der Commitsteuerung für die Transaktionsverarbeitung an.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*KEINE: Inaktiviert die Commitsteuerung für die Transaktionsverarbeitung. Für den Fall, dass die Replikation unterbrochen wird, wird kein Versuch unternommen, die Transaktionskonsistenz aufrechtzuerhalten.
*LEVEL1: Nur festgeschriebene Transaktionen werden vom Subskribenten empfangen. Der Subskribent wendet die Transaktion an, sobald die gesamte Transaktion vom Bereitsteller empfangen wurde. Wenn ein Subskribentenfehler auftritt, während die Transaktion angewendet wird, wird die Transaktion erneut gesendet und das Anwenden erfolgt beim nächsten Start der Replikationsfunktion.

Wenn Sie *LEVEL1 auswählen, muss die 'Inhaltsaktualisierung im aktiven Zustand' bei einem Bereitsteller (siehe Befehl CHGDMSVAL) inaktiviert sein.

Nachrichtengenerierungsstatus (MSGNOTNULL)

Gibt an, ob jedes Mal dieselbe Nachricht generiert werden soll, wenn versucht wird, NULL in eine Zieltabellenspalte zu replizieren, die nicht NULL-fähig ist.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: Es wird immer eine Nachricht generiert, wenn NULL in eine Zieltabellenspalte repliziert wird, die nicht NULL-fähig ist.
*NEIN: Es wird keine Nachricht generiert, wenn NULL in eine Zieltabellenspalte repliziert wird, die nicht NULL-fähig ist. Sie werden in keinem Fall benachrichtigt.

Datumsformat (DFTDATE)

Gibt das Datum an, das zurückgegeben wird, wenn ein ungültiges Datum an die Spaltenmanipulationsfunktion %TODATE übergeben wird.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*NEU: Gibt das Datum 1901-01-01 zurück.
*OLD: Gibt das Datum 0001-01-01 zurück.

Aktualisierungsintervall für Latenzmetriken (MONSAMPFRQ)

Der Zeitraum (in Sekunden) zwischen aufeinanderfolgenden Aktualisierungen an einem Datenspeicher, der für die Verwaltung von Replikationslatenzmetriken verwendet wird. Der Datenspeicher wird von Management Console referenziert, um Informationen zur Replikationslatenz darzustellen. Diese Einstellung gibt auch an, wie oft der Datenspeicher abgefragt wird, um festzulegen, ob die Latenz überschritten wurde oder kleiner ist als die angegebenen Schwellenwerteinstellungen. Latenznachrichten werden generiert, wenn die Latenzzeit die Schwellenwerte überschritten hat oder unter diesen liegt. Alerts können in der Managementkonsole als Reaktion auf eine generierte Nachricht konfiguriert werden.

Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet.

Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.

Zeit: Gibt den Zeitraum in Sekunden an.; Mindesteinstellung: 0 Sekunden. Wenn dieser Parameter auf 0 festgelegt wird, werden die Replikationslatenzmetriken im Datenspeicher nicht aktualisiert.; Höchsteinstellung: 3600 Sekunden (1 Stunde); Standardeinstellung: 5 Sekunden

Wartezeit für die Beendigung des Initialisierungsprozesses (STARTUP)

Die maximale Wartezeit (in Sekunden), bevor die CDC Replication -Initialisierungsphase beendet wird. Während der Initialisierung von CDC Replication vor der Datenreplikation kann die Beendigung des Prozesses auf dem Veröffentlichungs-oder Subskriptionsserver zu einer Aussetzung der Initialisierungsphase führen.

Dieser Parameter ermöglicht es Ihnen, in diesem Fall die maximale Wartezeit festzulegen.

Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet.

Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.

Zeit: Gibt den Zeitraum in Sekunden an.; Mindesteinstellung: 4 Sekunden; Höchsteinstellung: 3600 Sekunden (1 Stunde); Standardeinstellung: 120 Sekunden

Statusnachricht (PROGRESS)

Die Höchstwartezeit (in Sekunden), bevor die nächste Statusnachricht generiert wird. Die Statusnachrichten werden in das Ereignisprotokoll geschrieben.

Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet.

Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.

Zeit: Gibt den Zeitraum an.; Höchsteinstellung: 7200 Sekunden (2 Stunden); Mindesteinstellung: 0 Sekunden. Es werden keine Fortschrittsnachrichten ausgegeben.; Standardeinstellung: 0 Sekunden. Es werden keine Fortschrittsnachrichten ausgegeben.

Sperrenzeitlimit (LCKTIMEOUT)

Die Zeit in Sekunden, die CDC Replication wartet, bis eine Tabelle oder Zeile entsperrt wird, bevor eine Fehlernachricht im Ereignisprotokoll generiert wird.

Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet.

Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.

Zeit: Gibt den Zeitraum an.; Mindesteinstellung: 2 Sekunden; Höchsteinstellung: 60 Sekunden; Standardeinstellung: 30 Sekunden

Datensatzformatprüfung (RCDFMTCHK)

Gibt an, ob CDC Replication die Satzformate der physischen und logischen Dateien überprüft, wenn die physische Datei für den Empfang gespiegelter Daten mit einem eindeutigen Schlüssel ausgewählt wird.

*SAME: Behält die aktuelle Einstellung für diesen Parameter bei.; Dies ist die Standardeinstellung.
*JA: CDC Replication überprüft die Satzformate der physischen und logischen Dateien. Es kann nur eine physische Datei, die dasselbe Datensatzformat wie die logische Datei aufweist, als Ziel für gespiegelte Daten über einen eindeutigen Schlüssel ausgewählt werden.
*NEIN: CDC Replication überprüft nicht die Satzformate der physischen und logischen Dateien. Sie können eine physische Datei als Ziel gespiegelter Daten über einen eindeutigen Schlüssel auswählen, die nicht dasselbe Datensatzformat wie die logische Datei besitzt.

Prozentwert für die Totzone (DBPERCENT)

Die Größe des Bereichs, der jede Latenzschwellenwerteinstellung umgibt.

Basierend auf den Einstellungen für Latenzschwellenwerte, die in Management Consoledefiniert sind, wird eine Latenznachricht generiert, wenn die Latenzzeit überschritten wurde oder unter einem Schwellenwert liegt. Die Latenz wird in regelmäßigen Intervallen berechnet, wobei das Intervall durch die aktuelle Einstellung des Parameters MONSAMPFRQ bestimmt wird. Alerts können in der Managementkonsole als Reaktion auf eine generierte Nachricht konfiguriert werden.

Mit diesem Parameter, der als Prozentsatz ausgedrückt wird, können Sie einen Schwellenwert auf beiden Seiten gleich auffüllen, um einen Bereich um den Schwellenwert herum zu erstellen. Durch Anpassung dieses Parameters CDC Replication kann die Größe des Bereichs um den Schwellenwert herum erhöht oder verringert und der Schwellenwert selbst dicker oder dünner gemacht werden. Eine Latenznachricht wird nur generiert, wenn die Latenz die Obergrenze des Bereichs überschritten hat oder wenn sie unter der Untergrenze des Bereichs liegt. Durch Ändern des diesem Parameter zugewiesenen Werts können Sie die Anzahl der ins Ereignisprotokoll geschriebenen Latenznachrichten steuern. Ein Beispiel, das veranschaulicht, wie sich dieser Parameter auf die Anzahl der generierten Latenznachrichten auswirken kann, finden Sie unter dem Systemparameter Deadband Percentage .

Da es zwei Einstellungen für den Latenzschwellenwert in Management Console gibt (einen Warnungsschwellenwert und einen Fehlerschwellenwert), werden zwei separate Bereiche definiert, wenn dieser Parameter auf einen Wert ungleich null gesetzt wird. Jeder Bereich wird an seinen Schwellenwert angeschlossen, d. h., die beiden Bereiche können sich überlappen, ohne dass sich dadurch das Verhalten ändert. Wenn ein Wert angegeben wird, der kleiner als die Mindesteinstellung ist, wird die Mindesteinstellung verwendet. Wenn ein Wert angegeben wird, der größer als die Höchsteinstellung ist, wird die Höchsteinstellung verwendet.

Zahl: Gibt die Größe des Bereichs an.; Mindesteinstellung: 3%; Höchsteinstellung: 10%; Standardeinstellung: 3%

Lesezeichentraces zulassen (BKMKTRACE)

Gibt an, ob Lesezeichentraces zugelassen werden sollen.

*JA: Lässt Lesezeichentraces zu.
*NEIN: Lässt keine Lesezeichentraces zu.; Dies ist die Standardeinstellung.

Ergebnis

Ausgaberelevante Nachrichten werden im Jobprotokoll aufgezeichnet.

Beispiele

CHGDMTVAL NOTIFYQ(NOTQLIB/NOTQ1)
NOTIFYCNT(10) AUTCDE(23456789) REFRESH(*YES) MIRROR(*YES) COLUMNVAL(*NO)
NUMCOLMSG(*NB) CMTCTRL(*NONE) MSGNOTNULL(*NO) DFTDATE(*NEW) MONSAMPFRQ(240)
STARTUP(60) PROGRESS(45) LCKTIMEOUT(10) RCDFMTCHK(*NO) DBPERCENT(10)

Benachrichtigungen werden an die Nachrichtenwarteschlange NOTQ1 gesendet, die sich in Bibliothek NOTQLIB befindet.

CDC Replication erkennt bis zu 10 Fehler, bevor eine Benachrichtigung an die Nachrichtenwarteschlange gesendet wird.

Der Berechtigungscode ist 23456789.

Die Aktualisierung oder Spiegelung wird beendet, wenn CDC Replication einen Fehler feststellt.

Die Daten in jedem gepackten und gezonten Feld werden nicht geprüft, bevor sie auf die Zieltabelle angewendet werden.

Es werden keine Nachrichten gesendet, wenn leere oder nicht initialisierte numerische Felder festgestellt werden.

Die Commitsteuerung wird inaktiviert.

Es wird keine Nachricht generiert, wenn NULL in eine Zieltabellenspalte repliziert wird, die nicht NULL-fähig ist.

Das Datum, das zurückgegeben wird, wenn ein ungültiges Datum an die Spaltenbearbeitungsfunktion %TODATE übergeben wird, ist 1901-01-01.

Aktualisierungen an dem Datenspeicher, der für die Verwaltung der Replikationslatenzmetriken verwendet wird, erfolgen alle 240 Sekunden.

Die CDC Replication -Initialisierungsphase wird beendet, wenn sie nicht innerhalb von 60 Sekunden abgeschlossen werden kann.

Statusnachrichten werden alle 45 Sekunden generiert.

CDC Replication wartet 10 Sekunden, bis eine Tabelle oder Zeile entsperrt wird, bevor eine Fehlernachricht im Ereignisprotokoll generiert wird.

Die Datensatzformate der physischen und logischen Dateien werden nicht geprüft. Die physischen Dateien, die als Ziel gespiegelter Daten unter Verwendung eines eindeutiges Schlüssels ausgewählt wurden, können andere Datensatzformate haben als die logischen Dateien.

Um jede Latenzschwellenwerteinstellung liegt ein 10%-Bereich.

verwenden

Dieser Befehl bezieht sich nur auf Subskribenten.