Beschreibung

Mit dem Befehl CRTTRGPGM können Trigger-Programme erstellt und registriert werden.

Das Trigger-Programm wird zunächst mit dem Befehl CRTILEOBJ erstellt.

Trigger-Programme, die über diesen Befehl erstellt werden, werden grundsätzlich mit Aktivierungsgruppe *CALLER generiert. Durch die Erstellung und Ausführung der Trigger-Programme in der Aktivierungsgruppe *CALLER wird sichergestellt, dass COMMIT und ROLLBACK innerhalb der Aktivierungsgruppe (Unterlassungswert beim Befehl STRCMTCTL = Start Commitment Control) sauber ausgeführt werden.

Das Trigger-Programm wird anschließend über den Befehl ADDPFTRG mit den angegebenen Parametern registriert.


Abbildung 4: Befehl CRTTRGPGM - Erstellen Trigger-Programm

Parameter für Befehl CRTTRGPGM – Create Trigger Program

Trigger-Programm: Qualifiziertes Programm, das erstellt werden soll.
*LIBL Bibliotheksliste

Quellendatei:Qualifizierte Quellen-Datei, in der die Teildatei hinterlegt ist
*LIBL Quellen Datei wird in der Bibliotheksliste gesucht
*SRCLIB Quellen-Bibliothek

Quellenteildatei:Teildatei, die umgewandelt werden soll.
*PGMTeildatei-Name entspricht dem Namen des zu erstellenden Programms.

Pyhsische Datei (oder SQL-Tabelle) für die das Trigger-Programm registriert werden soll.
Auslöser-ZeitAktivierungszeitpunkt des Trigger-Programms
*BEFORE Ausführung des Trigger-Programms vor dem Schreiben, Ändern oder Löschen des Datensatzes
*AFTER Ausführung des Trigger-Programms nach dem Schreiben, Ändern oder Löschen des Datensatzes

Auslöser-Ereignis Ereignis, durch das das Trigger-Programm aktiviert wird
*INSERT Das Trigger-Programm wird durch das Schreiben eines Datensatzes in die angegebene Datei/Tabelle aktiviert
*UPDATE Das Trigger-Programm wird durch die Änderung eines Datensatzes in die angegebene Datei/Tabelle aktiviert
*DELETE Das Trigger-Programm wird durch das Löschen eines Datensatzes aus der angegebenen Datei/Tabelle aktiviert
*READ Das Trigger-Programm wird durch das Lesen eines Datensatzes aus der angegebenen Datei/Tabelle aktiviert.

Trigger-Name Name des Triggers
*PGM Der Trigger erhält den gleichen Namen wie das Programm

Aktualisierungsbedingung: Gibt an, ob das Trigger-Programm immer aufgerufen wird oder nur dann, wenn sich ein Wert in dem Datensatz ändert
*ALWAYS Das Trigger-Programm wird immer aufgerufen
*CHANGE Das Trigger-Programm wird nur aufgerufen wenn sich ein Wert in dem Datensatz ändert.

Wiederholte Änderung zulassen: Erforderlich bei Before-Insert oder Before-Update-Trigger, wenn in dem bereits geänderten Datensatz weitere Änderungen vorgenommen werden sollen (z.B. Aktualisierungsdatum/-Zeit soll gesetzt werden.)
*YES Wiederholte Änderungen sind zulässig
*NO Wiederholge Änderungen sind nicht zulässig
Zielrelease Gibt das Release für das das Modul, Programm oder Service-Programm erstellt werden soll.
*CURRENT Aktuelles Release
*PRV Vorhergehendes Release
VxRxMx Angabe des Releases z.B. V7R1M0
Umwandlung im Stapelbetrieb
J/NJ=Ja  Umwandlung erfolgt im Stapelbetrieb (QBATCH)
N=Nein  Interaktive Umwandlung

Beispiel: Erstellen Before Update Trigger

Abbildung 5: Beispiel - Erstellen Before Update Trigger mit CRTTRGPGM