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

DspKernel

Displays the Kernel window. You should restrict the use of this function because once you are in the Kernel, you can execute any Cicode function with no privilege restrictions. You therefore have total control of CitectSCADA (and subsequently your 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 CitectSCADA 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 CitectSCADA operation.
You should restrict access to the Kernel, because once you are in the Kernel, you can execute any Cicode function with no privilege restrictions. You therefore have total control of CitectSCADA (and subsequently your plant and equipment).

 

UNINTENDED EQUIPMENT OPERATION

  • Do not use the kernel for normal CitectSCADA 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 CitectSCADA and Cicode, or are under the direct guidance of Schneider Electric (Australia) Pty.Ltd. Support.

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

Syntax

DspKernel(iMode)

iMode:

The display mode of Kernel:

1 - Display the Kernel. If the Kernel is already displayed and iMode=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