Access the Controller object

The
Controller
object provides status information about controller execution.
Attribute
Data Type
Instruction
Description
Audit Value
DINT[2], LINT
GSV
The audit value is a unique value that is generated when a project is downloaded to the controller or loaded from removable storage. When a change is detected, this value is updated.
To specify which changes are monitored, use the ChangesToDetect attribute.
ChangesToDetect
DINT[2], LINT
GSV, SSV
Used to specify which changes are monitored. When a monitored change occurs, the Audit Value is updated.
CanUseRPIFrom
Producer
DINT
GSV
Identifies whether to use the RPI specified by the producer.
  • 0. Do not use the RPI specified by the producer.
  • 1. Use the RPI specified by the producer.
ControllerLog Execution Modification Count
DINT
GSV SSV
Number of controller log entries that originate from a program/task properties change, an online edit, or a controller timeslice change. It can also be configured to include log entries originating from forces. The number is reset if RAM enters a bad state. The number is not capped at the largest DINT, and a rollover can occur.
ControllerLog
TotalEntryCount
DINT
GSV SSV
Number of controller log entries since the last firmware upgrade. The number is reset if RAM enters a bad state. The number is capped at the largest DINT.
DataTablePad
Percentage
INT
GSV
Percentage (0...100) of free data table memory set aside.
IgnoreArrayFaultsDuringPostScan
SINT
GSV SSV
Used to configure the suppression of selected faults encountered when an SFC action is postscanned. Only valid when SFCs are configured for automatic reset.
  • 0. This value does not not suppress faults during postscan execution. This is the default and recommended behavior.
  • 1. This value automatically suppresses major faults 4/20 (Array subscript too large) and 4/83 (Value out of range) while postscanning SFC actions.
When a fault is suppressed, the controller uses an internal fault handler to automatically clear the fault. This causes the faulted instruction to be skipped, with execution resuming at the following instruction.
Because the fault handler is internal, you do not have to configure a fault handler to get this behavior. In fact, even if a fault handler is configured, a suppressed fault will not trigger it.
InhibitAutomatic
FirmwareUpdate
BOOL
GSV SSV
Identifies whether to enable the firmware supervisor.
  • 0. This value executes the firmware supervisor.
  • 1. This value does not execute the firmware supervisor.
KeepTestEditsOnSwitch over
SINT
GSV
Identifies whether to maintain test edits on controller switchover.
  • 0. This value automatically untests edits at switchover,
  • 1. This value continues testing edits at switchover.
Name
String
GSV
Name of the controller.
Redundancy
Enabled
SINT
GSV
Identifies whether the controller is configured for redundancy.
  • 0. This value indicates the controller is not configured for redundancy.
  • 1. This value indicates the controller is configured for redundancy.
ShareUnused
TimeSlice
INT
GSV SSV
Identifies how the continuous task and the background tasks shared any unused timeslice.
  • 0. This value indicates that the operating system does not give control to the continuous task even if background is complete.
  • 1. This value indicates that a continuous task runs even if the background tasks are complete. This is the default value.
  • 2. This value or greater logs a minor fault and leaves the setting unchanged.
TimeSlice
INT
GSV SSV
Percentage of available CPU (10-90) that is assigned to communications. This value cannot change when the keyswitch is in the Run position.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.