krn.OnRegisteredJobCall

Interner Job — nicht für den regulären Client-Einsatz. Teil der internen Live-Monitoring-/Callback-Infrastruktur des Servers (siehe krn.RegisterJobCall). Nur für Administrations-, Diagnose- oder Monitoring-Werkzeuge verwenden.

Dies ist kein Job, den ein Client aufruft — es ist die Benachrichtigung, die der Server nach krn.RegisterJobCall für jeden überwachten Jobaufruf an einen Callback-Kanal pusht. Sie wird als Methodenaufruf über den Callback-Kanal zugestellt; der Client beantwortet sie mit einer Standard-Methodenantwort (Rückgabecode 0).

Die Einrichtung des Callback-Kanals ist unter krn.GetChannelGUID (Abschnitt „Callback-Kanal") beschrieben.

1. Metadaten (fest zugestellt)

Name Typ Beschreibung

Job

STRING

Vollqualifizierter Name des überwachten Jobs (z. B. krn.SessionLogin).

Flags

INT

Phasenmarker: 1 = vor dem Aufruf · 4 = nach dem Aufruf (Erfolg) · 2 = nach dem Aufruf (Fehler).

UserName

STRING

Benutzer des überwachten Aufrufs (ANONYMOUS vor dem Login).

Instance

STRING

Instanzname des Client-Programms.

Computer

STRING

Rechner/Station des Clients.

ConnectIP

STRING

Quell-IP, wie sie der Server sieht.

Duration

STRING

Ausführungszeit des Aufrufs (z. B. 19.7 ms); in der Vorher-Benachrichtigung leer.

Time

STRING

Zeitstempel HH:MM:SS,mmm.

HRESULT

STRING/INT

Transport-Ergebnis.

ResponseResult

STRING/INT

Eigener Rückgabecode des überwachten Jobs.

FilesIn / FilesOut

STRING/INT

Anzahl der Request-/Response-Datei-Streams.

2. Dynamische Parameter (Parameter des überwachten Jobs)

Die Parameter des überwachten Jobs werden mit einem Präfix versehen und verbatim weitergereicht:

$$RJC$$_paramin_<name>     Eingabe-Parameter des überwachten Aufrufs
$$RJC$$_paramout_<name>    Ausgabe-Parameter (nur in der Nachher-/Erfolgs-Benachrichtigung)
$$RJC$$_error_FC_<n>       Fehler-Faultcode n   (nur wenn der Aufruf fehlschlug)
$$RJC$$_error_FS_<n>       Fehler-Faultstring n
$$RJC$$_error_SN_<n>       Fehler-Quellenname (Source Name) n

Der interne Parameter origprovenience ist vorhanden (oft leer).

Eingabeparameter werden verbatim weitergereicht, einschließlich sensibler Werte — etwa des verschlüsselten Login-Passworts (UserPwd) überwachter krn.SessionLogin-Aufrufe, das als Eingabeparameter (paramin-Präfix) unverändert mitgesendet wird. Dieser Datenstrom ist als privilegierte administrative Information zu behandeln.

3. Antwort des Clients

Der Client beantwortet jede gepushte krn.OnRegisteredJobCall mit einer normalen Methodenantwort (Rückgabecode 0, keine Parameter). Es ist kein Bestätigungsinhalt erforderlich.

4. Siehe auch