krn.OnRegisteredJobCall

Internal job — not for casual client use. Part of the server’s internal live-monitoring / callback infrastructure (see krn.RegisterJobCall). Use it only for administration, diagnostics or monitoring tooling.

This is not a job a client calls — it is the notification the server pushes to a callback channel for each monitored job call after krn.RegisterJobCall. It is delivered as a method call over the callback channel; the client answers with a standard method response (return code 0).

Establishing the callback channel is described in krn.GetChannelGUID (section "Callback channel").

1. Metadata (fixed)

Name Type Description

Job

STRING

The monitored job’s fully-qualified name (e.g. krn.SessionLogin).

Flags

INT

Phase marker: 1 = before call · 4 = after call (success) · 2 = after call (error).

UserName

STRING

User of the monitored call (ANONYMOUS before login).

Instance

STRING

Client program instance name.

Computer

STRING

Client computer/station.

ConnectIP

STRING

Source IP as seen by the server.

Duration

STRING

Execution time of the call (e.g. 19.7 ms); empty in the before notification.

Time

STRING

Timestamp HH:MM:SS,mmm.

HRESULT

STRING/INT

Transport-level result.

ResponseResult

STRING/INT

The monitored job’s own return code.

FilesIn / FilesOut

STRING/INT

Number of request/response file streams.

2. Dynamic Parameters (the monitored job’s parameters)

The monitored job’s parameters are forwarded verbatim, each with a prefix:

$$RJC$$_paramin_<name>     Input parameter of the monitored call
$$RJC$$_paramout_<name>    Output parameter (only in the after/success notification)
$$RJC$$_error_FC_<n>       Error fault code n   (present only when the call failed)
$$RJC$$_error_FS_<n>       Error fault string n
$$RJC$$_error_SN_<n>       Error source name n

The internal parameter origprovenience is present (often empty).

Input parameters are forwarded verbatim, including sensitive values — for example the encrypted login password (UserPwd) of monitored krn.SessionLogin calls, forwarded unchanged as an input parameter (paramin prefix). Treat this stream as privileged administrative data.

3. Client Response

The client answers each pushed krn.OnRegisteredJobCall with a normal method response (return code 0, no parameters). No acknowledgement content is required.

4. See Also