DspKernel

Displays the Kernel window.

To display the Kernel window, the user that is currently logged in needs to be assigned to a Role that has the Kernel Access property set to "Full Access" or "Read Only". A Read Only user can access the Kernel, but cannot perform some privileged commands like running Cicode. See Display the Kernel Window.

Note: The special Kernel user that enabled Kernel access in versions prior to Plant SCADA 2023 R2 no longer has default access to the Kernel window.

Kernel access should be restricted to authorised personnel only as once they are in the Kernel, they can execute any Cicode function without further privilege restrictions and therefore have total control of Plant SCADA (and subsequently the plant and equipment). Please be aware that you can also open the Kernel by setting the [Debug]Menu parameter to 1 and, when your system is running, selecting Kernel from the system menu.

You should be experienced with Plant SCADA and Cicode before attempting to use the Kernel as these facilities are powerful, and if used incorrectly, can corrupt your system.

Note:
• You should only use the Kernel for diagnostics and debugging purposes, and not for normal Plant SCADA operation.
• Kernel access should be restricted to authorised personnel only as once they are in the Kernel, they can execute any Cicode function without further privilege restrictions and therefore have total control of Plant SCADA (and subsequently the plant and equipment).

Syntax

DspKernel(nMode)

nMode:

The display mode of Kernel:

1 - Display the Kernel. If the Kernel is already displayed and nMode=1, the keyboard focus is changed to the Kernel.

0 - Hide the Kernel

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

KerCmd, TraceMsg

Example

DspKernel(1);
!Display the Runtime Kernel window

See Also

Display Functions