Cicode Programming Reference > Cicode Function Categories > Display Functions > DspKernel

DspKernel

Displays the Kernel window and prompts the user to login as the 'kernel' user. A corresponding 'kernel' user must have already been defined in the project. 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 Citect SCADA (and subsequently the plant and equipment). Please be aware that you can also open the Kernel by setting the Citect [Debug]Menu parameter to 1 and, when your system is running, selecting Kernel from the control-menu box.

Note: You should be experienced with Citect 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 Citect 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 Citect SCADA (and subsequently the plant and equipment).

 

UNINTENDED EQUIPMENT OPERATION

  • Do not use the kernel for normal Citect SCADA operation. The kernel is only for diagnostics and debugging purposes.
  • Configure your security so that only approved personnel can view or use the kernel.
  • Do not view or use the kernel unless you are an expert user of Citect SCADA and Cicode, or are under the direct guidance of Schneider Electric Support.

Failure to follow these instructions can result in death, serious injury, or equipment damage.

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 Citect Kernel window

See Also

Display Functions

Published June 2018