...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
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.
*LIBLBibliothekslisteLIBL Bibliotheksliste
Quellendatei:Qualifizierte Quellen-Datei, in der die Teildatei hinterlegt ist
*LIBLQuellen LIBL Quellen Datei wird in der Bibliotheksliste gesucht
*SRCLIBQuellenSRCLIB 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
*BEFOREAusführung BEFORE Ausführung des Trigger-Programms vor dem Schreiben, Ändern oder Löschen des Datensatzes
*AFTERAusführung AFTER Ausführung des Trigger-Programms nach dem Schreiben, Ändern oder Löschen des Datensatzes
Auslöser-EreignisEreignisEreignis Ereignis, durch das das Trigger-Programm aktiviert wird
*INSERTDas INSERT Das Trigger-Programm wird durch das Schreiben eines Datensatzes in die angegebene Datei/Tabelle aktiviert
*UPDATEDas UPDATE Das Trigger-Programm wird durch die Änderung eines Datensatzes in die angegebene Datei/Tabelle aktiviert
*DELETEDas DELETE Das Trigger-Programm wird durch das Löschen eines Datensatzes aus der angegebenen Datei/Tabelle aktiviert
*READDas READ Das Trigger-Programm wird durch das Lesen eines Datensatzes aus der angegebenen Datei/Tabelle aktiviert.
Trigger-NameName Name Name des Triggers
*PGMDer 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
*ALWAYSDas ALWAYS Das Trigger-Programm wird immer aufgerufen
*CHANGEDas 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.)
*YESWiederholte YES Wiederholte Änderungen sind zulässig
*NO Wiederholge Änderungen sind nicht zulässig
ZielreleaseGibt Zielrelease Gibt das Release für das das Modul, Programm oder Service-Programm erstellt werden soll.
*CURRENTAktuelles CURRENT Aktuelles Release
*PRVVorhergehendes PRV Vorhergehendes Release
VxRxMxAngabe 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 UpdateAnchor _GoBack _GoBack
Trigger
| _GoBack | |
| _GoBack |
Abbildung 5: Beispiel - Erstellen Before Update Trigger mit CRTTRGPGM