krn.RegisterJobCall

Interner Job — nicht für den regulären Client-Einsatz. Dieser Job gehört zur internen Live-Monitoring-/Callback-Infrastruktur des Servers und ist das Mittel, mit dem der Enterprise Manager den Server-Ereignisstrom anzeigt. Er ist nicht Teil der regulären Client-API, weitgehend undokumentiert und legt sensible Daten offen (siehe Sicherheitshinweis in krn.OnRegisteredJobCall). Parameter und Rückgabeformen können sich zwischen Serverversionen ändern. Nur für Administrations-, Diagnose- oder Monitoring-Werkzeuge verwenden — niemals in gewöhnlichen DMS-Anwendungsabläufen.

Registriert die aktuelle Session/den aktuellen Channel als serverweiten Live-Monitor für Jobaufrufe. Nach der Registrierung pusht der Server für jeden Aufruf eines in JobNames aufgeführten Jobs eine krn.OnRegisteredJobCall-Benachrichtigung über den Callback-Kanal der Session — über alle Sessions und Benutzer hinweg, nicht nur die des Aufrufers. Dies ist der Mechanismus hinter der Live-Ereignisansicht des Enterprise Managers.

Der Callback-Kanal muss für dieselbe Session bereits eingerichtet sein; die Mechanik ist unter krn.GetChannelGUID (Abschnitt „Callback-Kanal") beschrieben.

1. Eingabeparameter

Name Typ Pflicht Beschreibung

Flags

INT

Ja

Steuer-Flags. Der Enterprise Manager übergibt 1.

JobNames

STRING

Ja

Semikolon-separierte Liste vollqualifizierter Jobnamen, die überwacht werden sollen (z. B. krn.SessionLogin;dms.GetResultList). Der Enterprise Manager registriert praktisch den gesamten Job-Katalog.

BeforeToo

BOOLEAN

Ja

1 = zusätzlich zur Benachrichtigung nach dem Job auch eine vor dessen Ausführung pushen (ein überwachter Aufruf erzeugt dann zwei Benachrichtigungen). 0 = nur danach.

ErrorsOnly

BOOLEAN

Ja

1 = nur Benachrichtigungen für Aufrufe pushen, die mit einem Fehler endeten; erfolgreiche Aufrufe werden unterdrückt. 0 = alle Aufrufe.

FilesToo

BOOLEAN

Ja

1 = die Datei-Streams des überwachten Jobs in die Benachrichtigung einschließen. 0 = nur die FilesIn-/FilesOut-Anzahl, keine Datei-Bytes.

2. Rückgabe

(INT): 0 = Job erfolgreich, sonst Fehlercode.

3. Hinweise

  • Die Überwachung ist serverweit: Der registrierende Channel erhält Ereignisse für Jobaufrufe beliebiger verbundener Clients.

  • Beendet wird die Überwachung mit krn.DeregisterJobCall.

4. Siehe auch