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.
  *PGM           Teildatei-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