krn.RegisterJobCall

Internal job — not for casual client use. This job belongs to the server’s internal live-monitoring / callback infrastructure and is the mechanism the Enterprise Manager uses to display the server event stream. It is not part of the normal client API, is largely undocumented and exposes sensitive data (see the security note in krn.OnRegisteredJobCall). Its parameters and return shapes may change between server versions. Use it only for administration, diagnostics or monitoring tooling — never as part of ordinary DMS application flows.

Registers the current session/channel as a server-wide live monitor for job calls. After registration, the server pushes a krn.OnRegisteredJobCall notification over the session’s callback channel for every call of any job listed in JobNames — across all sessions and users, not just the caller’s. This is the mechanism behind the Enterprise Manager’s live event view.

The callback channel must already be established for the same session; the mechanism is described in krn.GetChannelGUID (section "Callback channel").

1. Input Parameters

Name Type Required Description

Flags

INT

Yes

Control flags. The Enterprise Manager passes 1.

JobNames

STRING

Yes

Semicolon-separated list of fully-qualified job names to monitor (e.g. krn.SessionLogin;dms.GetResultList). The Enterprise Manager registers essentially the full job catalogue.

BeforeToo

BOOLEAN

Yes

1 = also push a notification before the job executes, in addition to the one after it (one monitored call then produces two notifications). 0 = after only.

ErrorsOnly

BOOLEAN

Yes

1 = only push notifications for calls that ended with an error; successful calls are suppressed. 0 = all calls.

FilesToo

BOOLEAN

Yes

1 = include the monitored job’s file streams in the notification. 0 = only the FilesIn/FilesOut counts, no file bytes.

2. Return Value

(INT): 0 = job successful, otherwise error code.

3. Notes

  • Monitoring is server-wide: the registering channel receives events for job calls made by any connected client.

  • Stop monitoring with krn.DeregisterJobCall.

4. See Also