Eintragsparameter für Benutzerexits auf Tabellen- und Zeilenebene in RPG

Die folgende Liste beschreibt alle Parameter in der Eintragsparameterliste, die in jedem RPG-Benutzerexitprogramm auf Tabellen- und Zeilenebene definiert werden müssen.

Rückgabecode (RTNCD)
Der Rückgabecode, der angibt, ob das Benutzerexitprogramm erfolgreich ausgeführt wurde.
Geben Sie im Benutzerexitprogramm eine Fehlernachrichten-ID zurück, wenn Fehler im Benutzerexitprogramm aufgetreten sind, oder Leerzeichen, wenn keine Fehler im Benutzerexitprogramm aufgetreten sind.
Name des Benutzerexitprogramms (PGMNM)
Der Name des aufgerufenen Benutzerexitprogramms. Dies ist der Name des Programms, das Sie in Management Consoleangeben.
Benutzerexitpunkt (ENTRYB)
Der Benutzerexitpunkt auf Tabellen-/Zeilenebene, an dem das Benutzerexitprogramm aufgerufen wurde.
Dies sind die möglichen Rückgabewerte:
  • 1—Vor Löschen des Inhalts
  • 2—Nach Löschen des Inhalts
  • 3—Vor dem Einfügen
  • 4—Nach dem Einfügen
  • 5—Vor der Aktualisierung
  • 6—Nach der Aktualisierung
  • 7—Vor dem Löschen
  • 8—Nach dem Löschen
  • 9—Vor Inhaltsaktualisierung
  • 10—Nach Inhaltsaktualisierung
Bereitstellervorimage (BDATA)
Das Zeilenvorimage in der Quellentabelle.
Bereitstellernachimage (ADATA)
Das Zeilennachimage in der Quellentabelle.
NULL-Anzeiger-Anzahl für Bereitstellervorimage (BNULCB)
Die Anzahl der Felder im Vorimage, die Nullwerte enthalten können (NULL-fähig). Jedes NULL-fähige Feld hat einen NULL-Anzeiger.
NULL-Anzeiger-Anzahl für Bereitstellernachimage (ANULCB)
Die Anzahl der Felder im Nachimage, die Nullwerte enthalten können (NULL-fähig). Jedes NULL-fähige Feld hat einen NULL-Anzeiger.
NULL-Anzeiger für Bereitstellervorimage (BNULL)
NULL-Anzeiger für alle Felder im Vorimage, die Nullwerte enthalten können.
Dies sind die möglichen Rückgabewerte:
  • 0—NULL-fähiges Feld ist nicht auf NULL gesetzt.
  • 1—NULL-fähiges Feld ist auf NULL gesetzt.
NULL-Anzeiger für Bereitstellernachimage (ANULL)
NULL-Anzeiger für alle Felder im Nachimage, die Nullwerte enthalten können.
Dies sind die möglichen Rückgabewerte:
  • 0—NULL-fähiges Feld ist nicht auf NULL gesetzt.
  • 1—NULL-fähiges Feld ist auf NULL gesetzt.
Journaldaten für Bereitstellervorimage (BJRNL)
Journalsteuerinformationen, die dem Vorimage zugeordnet sind.
Journaldaten für Bereitstellernachimage (AJRNL)
Journalsteuerinformationen, die dem Nachimage zugeordnet sind.
Länge des endgültigen Images des Subskribenten (DTLNGT)
Die Länge des vollständig formatierten (endgültigen) Images, das auf die Zieltabelle angewendet wird.
Das vollständig formatierte (endgültige) Image und die Länge dieses Images enthalten in bestimmten Situationen inkonsistente Informationen. Beispiel: In folgender Situation, in der der Subskribentenjob im SQL-Aktualisierungsmodus läuft (in den Zielsystemparametern), wird eine Aktualisierungsoperation ausgeführt und es gibt Zielspalten mit Standardwerten. In diesem Fall beinhalten die Länge des endgültigen Images und das Image selbst nicht die Spalten mit den Standardwerten. Deswegen ist die Länge des endgültigen Images für eine Zeilenaktualisierungsoperation kürzer als die Länge des endgültigen Images für eine Zeileneinfügeoperation.
Endgültiges Image des Subskribenten (ATDATA)
Das vollständig formatierte (endgültige) Image, das auf die Zieltabelle angewendet wird.
Anmerkung: Wenn der Subskribentenjob im SQL-Aktualisierungsmodus (in den Zielsystemparametern) ausgeführt wird, wird eine Aktualisierungsoperation ausgeführt und es gibt Zielspalten mit Standardwerten. In diesem Fall beinhalten die Länge des endgültigen Images und das Image selbst nicht die Spalten mit den Standardwerten. Deswegen ist die Länge des endgültigen Images für eine Zeilenaktualisierungsoperation kürzer als die Länge des endgültigen Images für eine Zeileneinfügeoperation.
Das vollständig formatierte Image enthält die Ergebnisse von Datenumsetzungen, die auf das replizierte Nachimage in der Zielumgebung angewendet wurden. Bei Zieltabellen, die unter Auswertung, Zeilenkonsolidierung (Eins-zu-eins und Eins-zu-viele) und adaptiver Anwendung (Adaptive Apply) zugeordnet wurden, enthält dieses Image bei Aufrufen des Benutzerexitprogramms vor der Replikation nur Standardwerte (Leerzeichen, Nullen usw.) anstelle des endgültigen Images.
NULL-Anzeiger-Anzahl für endgültiges Image des Subskribenten (NULCNT)
Die Anzahl der Felder im vollständig formatierten (endgültigen) Image, die Nullwerte enthalten können (NULL-fähig). Jedes NULL-fähige Feld hat einen NULL-Anzeiger.
NULL-Anzeiger für endgültiges Image des Subskribenten (NULIND)
NULL-Anzeiger für alle NULL-fähigen Felder im vollständig formatierten (endgültigen) Image.
Dies sind die möglichen Rückgabewerte:
  • 0—NULL-fähiges Feld ist nicht auf NULL gesetzt.
  • 1—NULL-fähiges Feld ist auf NULL gesetzt.
Quellen-ID (SYSTEM)
Die Quellen-ID, die die Subskription angibt, die die Quellentabelle enthält. Quellen-IDs und Subskriptionen werden in Management Consoledefiniert.

Die Parameter BJRNL und AJRNL enthalten die folgenden Journalsteuerfelder.

Journaleintragslänge (JOEENTL)
Die Länge des Journaleintrags, die das Eintragslängenfeld und alle nachfolgenden Positionen des Journaleintrags umfasst.
Journalfolgenummer (JOSEQN)
Die dem Journaleintrag vom System zugewiesene Folgenummer.
Journalname (JOJRN)
Der Name des Journals.
Journalbibliothek (JOJRNLIB)
Der Name der Bibliothek, in der sich das Journal befindet.
Journalempfänger (JORCVNME)
Der Name des Journalempfängers, der dem Journal zugeordnet ist.
Journalempfängerbibliothek (JORCVLIB)
Der Name der Bibliothek, in der sich der Journalempfänger befindet.
Journaleintragscode (JOCODE)
Die primäre Kategorie des Journaleintrags.
Journaleintragstyp (JOENTT)
Der Typ des benutzer- oder systemerstellten Eintrags.
Systemeintragstyp (ENTTSYS)
Der Typ des systemerstellten Eintrags.
Journaleintragszeitmarke (JOTSTP)
Das Systemdatum und die Systemzeit zu dem Zeitpunkt, als der Eintrag aufgezeichnet wurde.
Name des Bereitstellerjobs (JOJOB)
Der Name des Jobs, der den Journaleintrag generiert hat.
Benutzer des Bereitstellerjobs (JOUSER)
Das Benutzerprofil des Benutzers, der den Job gestartet hat.
Nummer des Bereitstellerjobs (JONBR)
Die Jobnummer des Jobs, der den Journaleintrag generiert hat.
Name des Bereitstellerprogramms (JOPGM)
Der Name des Programms, das den Journaleintrag generiert hat.
Name der Quellentabelle (JOOBJ)
Der Name der Quelle, für die der Journaleintrag generiert wurde.
Quellentabellenbibliothek (JOLIB)
Der Name der Bibliothek, die die Quellentabelle enthält.
Name des Quellentabellenmembers (JOMBR)
Der Name des physischen Dateimembers.
Publizierungs-RRN (JOCTRR)
Die relative Datensatznummer (Relative Record Number, RRN) der Zeile, die den Journaleintrag verursacht hat - oder eine Zahl, die für den spezifischen Typ des Journaleintrags relevant ist.
Journalflag (JOFLAG)
Gibt auf Basis des Eintragstyps an, ob erweiterte Informationen vorliegen.
Die folgenden Werte bestimmen, ob erweiterte Informationen zur Verfügung gestellt werden:
  • 1 — Erweiterte Informationen sind verfügbar.
  • 0 — Es stehen keine erweiterten Informationen zur Verfügung.
Die erweiterten Informationen werden direkt nach den eintragsspezifischen Daten angegeben und haben die folgende Struktur:
Länge (4 Byte)
Gesamtlänge des erweiterten Eintrags.
Format (7 Byte)
Format der erweiterten Informationen.
Aktuell ist dies 'DM_0100'.
Erweiterter Objektname (128 Byte)
Vollständiger Name der Quellentabelle.
Erweiterter Schemaname (137 Byte)
Vollständiger Name des Quellenschemas.
Commitzyklus-ID (JOCCID)
Die Nummer, die den Commitzyklus angibt. Diese Nummer gilt nur für einen Eintrag, der einer Committransaktion zugeordnet ist.
Benutzer des Bereitstellerjobs (JOUSPF)
Der Name des Benutzerprofils, unter dem der Job ausgeführt wurde, als der Eintrag erstellt wurde.
Name des Publizierungsservers (JOSYNM)
Der Name des Systems, auf dem der Journaleintrag generiert wurde.

Die gesamte Länge aller Journalsteuerfelder ist 191. Dies entspricht der definierten Größe der beiden Parameter BJRNL und AJRNL.