Variable

 

Remarks Properties Methods DynProperties Samples

ED
avaliable
RT
avaliable

Remarks:Top

The collection Variables contains all defined variables of the current project. With this collection you can access all or selected variables. Beside the access via the index a variable also can be found with its unique name or the unique channel Id.

Properties:Top

Alignment AlternateValue ArraySize
BaseType BitAddr DataBlock
DataType Digits IsArray
LastUpdateTime LastUpdateTimeMilliSeconds Name
NetAddr Offset Parent
PvID RangeMax RangeMin
ReadOnly Recourceslabel SignalMax
SignalMin StatusExtValue StatusString
StatusValue StringLength Tagname
Unit UserValue  

Methods:Top

ActivateSubItem CalcPrimaryUnitValue CalcSecondaryUnitValue
CheckIn CheckOut CreateDynProperty
CreateEdLimit DeactivateSubItem DeleteEdLimit
Driver DynPropertiesEnum[GET] DynProperties[GET]
DynProperties[PUT] EdLimitCount EdLimitItem
Get IsCheckedOut IsDifferent
IsLimitActiv IsLocked IsOnline
IsRDAActiv IsRemaActiv Limits
SecondaryUnitDigits[GET] SecondaryUnitName[GET] SetValueWithStatus
SetValueWithStatusEx SubItem SubItemCount
SubItemName UndoCheckOut Value[GET]
Value[PUT]    

DynProperties:Top

Internal Variable [ED] Mathematics Variable [ED] Variable Editor
Variable Runtime    

Internal Variable [ED]Top

Name Type Description
AdjustHardware ZT_VBAMAKRO

AdjustHardwareValue

Only available, if non-linear value adjustment is active:
Macro is executed with every change of the raw value (PLC) to update the value in the control system.

Read more in the online manual

AdjustZenon ZT_VBAMAKRO

AdjustScadaValue

Only available, if non-linear value adjustment is active:
Macro is executed when setting a value in the control system to update the raw value (PLC).

Read more in the online manual

Adressparam String

ext. address parameters

External property for straton. Only affects variables that are not variables of the straton driver.
Profile properties in straton (like "embedded" or address parameters for Profibus).

More in the online help

AlarmDomain Long

Alarm area

Here the variable can be linked to an alarm area.

Read more in the online manual

AlarmPV0 ZT_VARIABLE

Alarm variable 1

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmPV1 ZT_VARIABLE

Alarm variable 2

Only available in SICAM 230.
Second variable for the picture alarm.

More in the online help

AlarmPV2 ZT_VARIABLE

Alarm variable 3

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmQuitPV ZT_VARIABLE

Acknowledgement variable

Whenever an alarm of this variable is acknowledged, the selected variable is set to the value defined under "Acknowledgement value".

Read more in the online manual

AlarmQuitPVValue Long

Acknowledgement value

Whenever an alarm of this variable is acknowledged, the variable selected under "Acknowledgement variable" is set to this value.

Read more in the online manual

Alignment Long

Alignment

Depending on the granularity of the driver the position of the variable within the offset.

For byte variables:
HiByte: High byte in the word offset.
LoByte: Low byte in the word offset.
HiWord-HiByte: High byte of the high word in the doubleword offset.
HiWord-LoByte: Low byte of the high word in the doubleword offset.
LoWord-HiByte: High byte of the low word in the doubleword offset.
LoWord-LoByte: Low byte of the low word in the doubleword offset.

For word variables:
HiWord: High word in the doubleword offset.
LoWord: Low word in the doubleword offset.

Read more in the online manual

AlternateValue Double

Alternate value

The alternate value is used, if the control system needs a value of the variable but no value is available.
This value is used to fill cyclic archives in times, when there was no connection to the hardware.
Additionally the variable can be set to the alternate value instead of the spontaneous value with the standard "Set value" box, the Recipegroup Manager (RGM) or the Report Generator.

Read more in the online manual

AlternateValueString String

String alternative value

The alternate string value is used, if the control system needs a value of the string variable but no value is available.
(e.g. to fill cyclic archives)

ATTENTION: This property is not available for language switching.

Read more in the online manual

AreaName ZT_String_REF Gets/Sets the alarm area of a variable.
ArraySizeOld Long

Array size

Only for compatibility reasons.

Read more in the online manual

BitAddr Long

Bit number

Number of the bit within the defined offset.
Minimum: 0.
Maximum: 65535.
Default: 0.

Read more in the online manual

CounterGroup Long

Counter group

Only available in SICAM 230.

DDEActive Boolean

DDE active

Active: The variable is available for other Windows applications.(e.g. Excel, Visual-Basic, etc.). Windows applications with DDE client functionality can thus use the variable values. The update time is 0.5 s.
Inactive: The variable is not availabe for other Windows applications.
Default: inactive.

Read more in the online manual

DataBlock Long

Data block

Number of the datablock.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Digits Long

Decimals

Number of decimals of the variable value for the display in the control system.
Minimum: 0.
Maximum: 5.
Default: 0.

Read more in the online manual

Driver Long

Driver

Driver for the variable; is selected on creating the variable and can be changed here lateron.

Read more in the online manual

ExternVisible Boolean

externally visible

External property for straton. Only affects variables, that are not of the straton driver.
Active: The variable is also visible in straton and can therefore be used in straton projects. The variable definition cannot be changed in straton. The value of the variable can be changed, though.
Inactive: The variable is not visible in straton.
Default: inactive.

ATTENTION: variable names for straton must meet the requirements of the IEC 61131-3, i.e. only numbers, letters (no umlauts) and underscores are allowed. In addition, the name must not begin with a number.
This also implies that structures and arrays are not visible from the outside, because they contain brackets and dots.

More in the online help

HDActive Boolean

HD active

Active: Variable values are stored on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.
Inactive: No variable values are stored.
Default: inactive.

HD data need 24 bytes of storage place per value, independent of the variable type. Beside the value the following information is stored:
- Time, when the value was read.
- Milliseconds when reading the value.
- Status of the value to correctly adapt elements.
- Counter for the unique identification of the value (spontaneous drivers).

Read more in the online manual

HDSize Long

Number of values

Only available, if harddisk data (HD) storage is active:
Number of values for the storage of online values on the harddisk (ring buffer) for the evaluation in the dynamic element "Trend element" or the export/import of the values.

Read more in the online manual

HDUpdate Float

Scan rate [s]

Only available, if harddisk data (HD) storage is active:
Interval time [in seconds] for the storage of on-line values on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.

Read more in the online manual

HystNeg Double

negative

The control system only realizes decreasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

HystPos Double

positive

The process control system only realizes increasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

ID_ComplexVariable Long With this property you have the opportunity to get/set the ID of a variable from a structure element. This ID is 0 when the variable has no structure datatype.
ID_DataTyp Long

Datatype

Datatype of the variable; is selected on creating the variable and can be changed here lateron.

ATTENTION: If the datatype is changed all the other properties of the variable have to be checked resp. modified.

Read more in the online manual

ID_DriverTyp Long

Driver object type

Depending on the selected driver on creating a variable the object type has to be selected and can be changed here lateron.
Siemens: datablock, marker, input/output.
Modbus: coil and holding register.

Read more in the online manual

InOut Boolean

Setting values active

Active: "Set value" actions for this variable are possible.
Inactive: This variable is read-only.
Default: active.

Read more in the online manual

InitialValue String

external init value

External property for straton. Only affects variables that are not of the straton driver.
Initial value of the variable in straton during cold start or warm start.
The input allowed here depends on the data type of the variable. For example, you can only use values without decimal places for whole-number variables. When using floating point variables, you have to use a dot as the decimal separator; a comma will not work
The control system does not validate your input here. This can lead to an error message in straton.

ATTENTION: When using variables of the internal driver, this property must have the same value as the initial value in the settings for internal variables.

More in the online help

Initial_value String

Initial value

On starting the Runtime the value defined here is used as the current value of the variable, if the property "Remanence" is set to "Initial value".

Read more in the online manual

IsKDAActiv Boolean

Recording type

Only available, if harddisk data (HD) storage is active:
Harddisk values (cyclic): Cyclic writing of the values on the harddisk
Postsorted values (RDA): The values are written blockwise by the driver on to the harddisk (post mortem mechanism).

Read more in the online manual

IsLocalAdjustHW Boolean With this property you have the opportunity to decide whether the "AdjustHardwareValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAdjustZenon Boolean With this property you have the opportunity to decide whether the "AdjustZenOnValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmDomain Boolean With this property you have the opportunity to decide whether the "Alarm area" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV0 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 1" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV1 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 2" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV2 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 3" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAltValString Boolean With this property you have the opportunity to decide whether the "String alternative value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlternateValue Boolean With this property you have the opportunity to decide whether the "Alternate value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalArraySize Boolean With this property you have the opportunity to decide whether the "Array size" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalCounterGroup Boolean
IsLocalDDEaktiv Boolean With this property you have the opportunity to decide whether the "DDE active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalDigits Boolean With this property you have the opportunity to decide whether the "Decimals" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDActive Boolean With this property you have the opportunity to decide whether the "HD active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDSize Boolean With this property you have the opportunity to decide whether the "Number of HD values" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDUpdate Boolean With this property you have the opportunity to decide whether the "HD scan rate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystNeg Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystPos Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalInOut Boolean With this property you have the opportunity to decide whether the "Setting values active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalKDAActiv Boolean With this property you have the opportunity to decide whether the "Recording type" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalLocking Boolean With this property you have the opportunity to decide whether the "Interlocking" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalMaxGradient Boolean
IsLocalNormalState Boolean
IsLocalNormalStateActive Boolean
IsLocalQuitPV Boolean With this property you have the opportunity to decide whether the "Acknowledgement variable" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalQuitValue Boolean With this property you have the opportunity to decide whether the "Acknowledgement value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMax Boolean With this property you have the opportunity to decide whether the "Maximum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMin Boolean With this property you have the opportunity to decide whether the "Minimum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRecLabel Boolean With this property you have the opportunity to decide whether the "Ressources label" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRema Boolean With this property you have the opportunity to decide whether the "Reaction matrix" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRemaActiv Boolean With this property you have the opportunity to decide whether the "Reaction matrix active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSBO Boolean With this property you have the opportunity to decide whether the "Select before operate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMax Boolean With this property you have the opportunity to decide whether the "Maximum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMin Boolean With this property you have the opportunity to decide whether the "Minimum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStandby Boolean With this property you have the opportunity to decide whether the "Only read from standby" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStingLength Boolean With this property you have the opportunity to decide whether the "String length" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalTagname Boolean With this property you have the opportunity to decide whether the "Identification" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUnit Boolean With this property you have the opportunity to decide whether the "Unit" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUpdatePriority Boolean With this property you have the opportunity to decide whether the "Priority of the driver connection" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUseMacro Boolean With this property you have the opportunity to decide whether the "Non linear value adjustment with macros" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMax Boolean With this property you have the opportunity to decide whether the "Maximum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMin Boolean With this property you have the opportunity to decide whether the "Minimum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalVarInASM Boolean With this property you have the opportunity to decide whether the "Save in IPA database" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsRemaActiv Boolean

Reaction matrix active

Active: Instead of limits a reaction matrix is used.
Inactive: Limits can be defined for the variable.
Default: inactive.

Read more in the online manual

IsSWProtokol Long
IsSW_Akt Boolean
IsSW_VBA Boolean
Limits SUBITEM

Limits

Properties for the limit or alarm behaviour of the variable.

Read more in the online manual

Local Boolean

Calculation

Local: In network projects the internal variable is evaluated resp. handled locally i.e. on the client.
I.e. the value of the variable can be different on each client and the limits are also evaluated locally.
Network: In network projects the internal variable is evaluated resp. handled on the server of the project. It has the same value on the server and on all clients.
Default: local.

Read more in the online manual

LockingName String With this property you have the opportunity to assign an interlocking via its name.

zElement.DynProperties("LockingName") = "Interlocking 1"

MaxGradient Long

Maximum gradient

Only available in SICAM 230.

Name String

Name

Unique name of the variable.

ATTENTION: This property is not available for language switching.

Read more in the online manual

NetAddr Long

Net address

Bus address or net address of the variable.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

NormalState Boolean

Normal value

Choose from the dropdown menu whether the normal value for this variable or data type should be On or Off. Available for variables and data types of the type BOOL, UINT and WORD for all drivers.

Default: On

NormalStateActive Boolean

Active

Allows the definition of a normal status for variables and data types of the type BOOL, UINT and WORD for all drivers.

Active: A normal status can be defined.

Default: inactive

Offset Long

Offset

Offset of the variable.
For linear addressing PLCs: the memory area.
For PLCs with a name resolution: the allocation address.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Profilename String

external profile name

External property for straton. Only affects variables that are not of the straton driver.
Name of the configured profile in straton (e.g. STRATON, ProfDP).

More in the online help

RangeMax Double

Measuring range max.

Maximum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

RangeMin Double

Measuring range min.

Minimum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

ReadWrite Boolean

external read/write

External property for straton. Only affects variables, that are not of the straton driver.
Active: The value of the variable can be changed in straton. The variable definition cannot be changed in straton.
Inactive: The variable cannot be changed in straton.
Default: active.

More in the online help

Recourceslabel String

Resources label

Freely definable string.
Is not used within the control system, but is available in export files to allow an identification of the exorted values for management systems (e.g. ERP).

Read more in the online manual

Rema Long

Reaction matrix

Only available, if reaction matrix is active:
Selection of the reaction matrix that should be used for the variable.

Read more in the online manual

Remanenz Long

Remanence

Initial value: On starting the Runtime the currrent value of the variable is set to the value entered in the property "Initial value".
Off: The start value of the variable is set to the alternate value resp. To an empty string for string variables.
Remanent: The start value of the variable is the last current value.
Default: off.

Read more in the online manual

SBO Boolean

Select Before Operate

Active: Before the value of the variable is written to the hardware, the control system makes sure, that the variable in the hardware is ready for the action. (=Select before operate; SBO)
Inactive: The value of the variable is written to the hardware without a previous request. (=Direct execute)
Default: inactive.

ATTENTION: This function is only supported by the IEC drivers.

Read more in the online manual

SV_Act Boolean

Old and new value

Active: On setting the value of this variable the old value and the new value are logged in the Chronologic Event List (CEL).
Inactive: Only the new value is logged.
Default: inactive.

Read more in the online manual

SV_VBA Boolean

Setting values with VBA

Active: Setting the value of this variable in VBA macro is logged in the Chronologic Event List (CEL).
Inactive: Setting the value of this variable in a VBA macro is not logged.
Default: active.

Read more in the online manual

SetValueProtocol Long

Logging

All: All "set value" actions of this variable with dynamic elements and "set value" functions are logged in the Chronologic Event List (CEL).
Nothing: No "set value" actions are logged in the CEL.
Only with dyn. element: Only "set value" actions with dynamic elements are logged in the CEL.
Default: Only with dyn. element.

Read more in the online manual

SignalMax Double

Signal resolution max.

Maximum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

SignalMin Double

Signal resolution min.

Minimum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

Standby Boolean

Only read from standby

Active: The value of the variable is displayed from the standby server.
Inactive: The value of the variable is displayed from the server.
(only for hardware drivers)

Read more in the online manual

StringLength Long

String length

Only available for string variables:
Maximum number of characters the variable can contain.
Minimum: 0 characters.
Maximum: 65535 characters.
Default: 5 characters.

Read more in the online manual

Tagname String

Identification

Freely definable string for the identification of the variable or the datatype.

Example: Can be used instead of the variable name in the online language change, as the name cannot be switched.

Read more in the online manual

Unit String

Unit

Technical unit of the variable for display in the control system.
Maximum: 50 characters.
Default: empty.

Read more in the online manual

UpdatePriority Long

Priority

If the global update time in the driver configuration is not used, update rates for the different priority levels can be set there. Here a priority level is linked to the variable.

Read more in the online manual

UseMacro Boolean

Non linear value adjustment with macros

The non-linear value adjustment is used for variables, whose original value (PLC) can not be scaled to the control system value in a linear way.
Activ: PLC values are scaled to control system values in a non-linear way (with VBA macros).
After activating the property "Non-linear value adjustment" the VBA macros for the calculation have to be entered under "AdjustHardwareValue" and "AdjustZenOnValue".
Inactive: PLC values are scaled to control system values in a linear way.
Default: inactive.

Read more in the online manual

ValueMax Double

Max. set value

The maximum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

ValueMin Double

Min. set value

The minimum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

VarInASM Boolean

save in IPA database

Active: The alarms of this variable are available for the evaluation in the Industrial Performance Analyzer (IPA).
Inactive: The alarms of this variable are ignored for the evaluation in the Industrial Performance Analyzer.
Default: inactive.

ATTENTION: The Industrial Performance Analyzer is an optional module and has to be licensed, so that it can be used here.

Read more in the online manual

Vargroup String

external variable group

External property for straton. Only affects variables that are not of the straton32 driver.
Variable groups in straton ("Global" or "Retain" or empty).

More in the online help

Mathematics Variable [ED]Top

Name Type Description
AdjustHardware ZT_VBAMAKRO

AdjustHardwareValue

Only available, if non-linear value adjustment is active:
Macro is executed with every change of the raw value (PLC) to update the value in the control system.

Read more in the online manual

AdjustZenon ZT_VBAMAKRO

AdjustScadaValue

Only available, if non-linear value adjustment is active:
Macro is executed when setting a value in the control system to update the raw value (PLC).

Read more in the online manual

Adressparam String

ext. address parameters

External property for straton. Only affects variables that are not variables of the straton driver.
Profile properties in straton (like "embedded" or address parameters for Profibus).

More in the online help

AlarmDomain Long

Alarm area

Here the variable can be linked to an alarm area.

Read more in the online manual

AlarmPV0 ZT_VARIABLE

Alarm variable 1

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmPV1 ZT_VARIABLE

Alarm variable 2

Only available in SICAM 230.
Second variable for the picture alarm.

More in the online help

AlarmPV2 ZT_VARIABLE

Alarm variable 3

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmQuitPV ZT_VARIABLE

Acknowledgement variable

Whenever an alarm of this variable is acknowledged, the selected variable is set to the value defined under "Acknowledgement value".

Read more in the online manual

AlarmQuitPVValue Long

Acknowledgement value

Whenever an alarm of this variable is acknowledged, the variable selected under "Acknowledgement variable" is set to this value.

Read more in the online manual

Alignment Long

Alignment

Depending on the granularity of the driver the position of the variable within the offset.

For byte variables:
HiByte: High byte in the word offset.
LoByte: Low byte in the word offset.
HiWord-HiByte: High byte of the high word in the doubleword offset.
HiWord-LoByte: Low byte of the high word in the doubleword offset.
LoWord-HiByte: High byte of the low word in the doubleword offset.
LoWord-LoByte: Low byte of the low word in the doubleword offset.

For word variables:
HiWord: High word in the doubleword offset.
LoWord: Low word in the doubleword offset.

Read more in the online manual

AlternateValue Double

Alternate value

The alternate value is used, if the control system needs a value of the variable but no value is available.
This value is used to fill cyclic archives in times, when there was no connection to the hardware.
Additionally the variable can be set to the alternate value instead of the spontaneous value with the standard "Set value" box, the Recipegroup Manager (RGM) or the Report Generator.

Read more in the online manual

AlternateValueString String

String alternative value

The alternate string value is used, if the control system needs a value of the string variable but no value is available.
(e.g. to fill cyclic archives)

ATTENTION: This property is not available for language switching.

Read more in the online manual

AreaName ZT_String_REF Gets/Sets the alarm area of a variable.
ArraySizeOld Long

Array size

Only for compatibility reasons.

Read more in the online manual

BitAddr Long

Bit number

Number of the bit within the defined offset.
Minimum: 0.
Maximum: 65535.
Default: 0.

Read more in the online manual

CounterGroup Long

Counter group

Only available in SICAM 230.

DDEActive Boolean

DDE active

Active: The variable is available for other Windows applications.(e.g. Excel, Visual-Basic, etc.). Windows applications with DDE client functionality can thus use the variable values. The update time is 0.5 s.
Inactive: The variable is not availabe for other Windows applications.
Default: inactive.

Read more in the online manual

DataBlock Long

Data block

Number of the datablock.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Digits Long

Decimals

Number of decimals of the variable value for the display in the control system.
Minimum: 0.
Maximum: 5.
Default: 0.

Read more in the online manual

Driver Long

Driver

Driver for the variable; is selected on creating the variable and can be changed here lateron.

Read more in the online manual

ExternVisible Boolean

externally visible

External property for straton. Only affects variables, that are not of the straton driver.
Active: The variable is also visible in straton and can therefore be used in straton projects. The variable definition cannot be changed in straton. The value of the variable can be changed, though.
Inactive: The variable is not visible in straton.
Default: inactive.

ATTENTION: variable names for straton must meet the requirements of the IEC 61131-3, i.e. only numbers, letters (no umlauts) and underscores are allowed. In addition, the name must not begin with a number.
This also implies that structures and arrays are not visible from the outside, because they contain brackets and dots.

More in the online help

HDActive Boolean

HD active

Active: Variable values are stored on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.
Inactive: No variable values are stored.
Default: inactive.

HD data need 24 bytes of storage place per value, independent of the variable type. Beside the value the following information is stored:
- Time, when the value was read.
- Milliseconds when reading the value.
- Status of the value to correctly adapt elements.
- Counter for the unique identification of the value (spontaneous drivers).

Read more in the online manual

HDSize Long

Number of values

Only available, if harddisk data (HD) storage is active:
Number of values for the storage of online values on the harddisk (ring buffer) for the evaluation in the dynamic element "Trend element" or the export/import of the values.

Read more in the online manual

HDUpdate Float

Scan rate [s]

Only available, if harddisk data (HD) storage is active:
Interval time [in seconds] for the storage of on-line values on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.

Read more in the online manual

HystNeg Double

negative

The control system only realizes decreasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

HystPos Double

positive

The process control system only realizes increasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

ID_ComplexVariable Long With this property you have the opportunity to get/set the ID of a variable from a structure element. This ID is 0 when the variable has no structure datatype.
ID_DataTyp Long

Datatype

Datatype of the variable; is selected on creating the variable and can be changed here lateron.

ATTENTION: If the datatype is changed all the other properties of the variable have to be checked resp. modified.

Read more in the online manual

ID_DriverTyp Long

Driver object type

Depending on the selected driver on creating a variable the object type has to be selected and can be changed here lateron.
Siemens: datablock, marker, input/output.
Modbus: coil and holding register.

Read more in the online manual

InOut Boolean

Setting values active

Active: "Set value" actions for this variable are possible.
Inactive: This variable is read-only.
Default: active.

Read more in the online manual

InitialValue String

external init value

External property for straton. Only affects variables that are not of the straton driver.
Initial value of the variable in straton during cold start or warm start.
The input allowed here depends on the data type of the variable. For example, you can only use values without decimal places for whole-number variables. When using floating point variables, you have to use a dot as the decimal separator; a comma will not work
The control system does not validate your input here. This can lead to an error message in straton.

ATTENTION: When using variables of the internal driver, this property must have the same value as the initial value in the settings for internal variables.

More in the online help

IsKDAActiv Boolean

Recording type

Only available, if harddisk data (HD) storage is active:
Harddisk values (cyclic): Cyclic writing of the values on the harddisk
Postsorted values (RDA): The values are written blockwise by the driver on to the harddisk (post mortem mechanism).

Read more in the online manual

IsLocalAdjustHW Boolean With this property you have the opportunity to decide whether the "AdjustHardwareValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAdjustZenon Boolean With this property you have the opportunity to decide whether the "AdjustZenOnValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmDomain Boolean With this property you have the opportunity to decide whether the "Alarm area" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV0 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 1" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV1 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 2" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV2 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 3" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAltValString Boolean With this property you have the opportunity to decide whether the "String alternative value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlternateValue Boolean With this property you have the opportunity to decide whether the "Alternate value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalArraySize Boolean With this property you have the opportunity to decide whether the "Array size" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalCounterGroup Boolean
IsLocalDDEaktiv Boolean With this property you have the opportunity to decide whether the "DDE active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalDigits Boolean With this property you have the opportunity to decide whether the "Decimals" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDActive Boolean With this property you have the opportunity to decide whether the "HD active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDSize Boolean With this property you have the opportunity to decide whether the "Number of HD values" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDUpdate Boolean With this property you have the opportunity to decide whether the "HD scan rate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystNeg Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystPos Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalInOut Boolean With this property you have the opportunity to decide whether the "Setting values active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalKDAActiv Boolean With this property you have the opportunity to decide whether the "Recording type" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalLocking Boolean With this property you have the opportunity to decide whether the "Interlocking" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalMaxGradient Boolean
IsLocalNormalState Boolean
IsLocalNormalStateActive Boolean
IsLocalQuitPV Boolean With this property you have the opportunity to decide whether the "Acknowledgement variable" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalQuitValue Boolean With this property you have the opportunity to decide whether the "Acknowledgement value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMax Boolean With this property you have the opportunity to decide whether the "Maximum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMin Boolean With this property you have the opportunity to decide whether the "Minimum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRecLabel Boolean With this property you have the opportunity to decide whether the "Ressources label" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRema Boolean With this property you have the opportunity to decide whether the "Reaction matrix" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRemaActiv Boolean With this property you have the opportunity to decide whether the "Reaction matrix active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSBO Boolean With this property you have the opportunity to decide whether the "Select before operate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMax Boolean With this property you have the opportunity to decide whether the "Maximum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMin Boolean With this property you have the opportunity to decide whether the "Minimum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStandby Boolean With this property you have the opportunity to decide whether the "Only read from standby" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStingLength Boolean With this property you have the opportunity to decide whether the "String length" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalTagname Boolean With this property you have the opportunity to decide whether the "Identification" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUnit Boolean With this property you have the opportunity to decide whether the "Unit" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUpdatePriority Boolean With this property you have the opportunity to decide whether the "Priority of the driver connection" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUseMacro Boolean With this property you have the opportunity to decide whether the "Non linear value adjustment with macros" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMax Boolean With this property you have the opportunity to decide whether the "Maximum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMin Boolean With this property you have the opportunity to decide whether the "Minimum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalVarInASM Boolean With this property you have the opportunity to decide whether the "Save in IPA database" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsRemaActiv Boolean

Reaction matrix active

Active: Instead of limits a reaction matrix is used.
Inactive: Limits can be defined for the variable.
Default: inactive.

Read more in the online manual

IsSWProtokol Long
IsSW_Akt Boolean
IsSW_VBA Boolean
Limits SUBITEM

Limits

Properties for the limit or alarm behaviour of the variable.

Read more in the online manual

LockingName String With this property you have the opportunity to assign an interlocking via its name.

zElement.DynProperties("LockingName") = "Interlocking 1"

MathInfo SUBITEM
MaxGradient Long

Maximum gradient

Only available in SICAM 230.

Name String

Name

Unique name of the variable.

ATTENTION: This property is not available for language switching.

Read more in the online manual

NetAddr Long

Net address

Bus address or net address of the variable.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

NormalState Boolean

Normal value

Choose from the dropdown menu whether the normal value for this variable or data type should be On or Off. Available for variables and data types of the type BOOL, UINT and WORD for all drivers.

Default: On

NormalStateActive Boolean

Active

Allows the definition of a normal status for variables and data types of the type BOOL, UINT and WORD for all drivers.

Active: A normal status can be defined.

Default: inactive

Offset Long

Offset

Offset of the variable.
For linear addressing PLCs: the memory area.
For PLCs with a name resolution: the allocation address.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Profilename String

external profile name

External property for straton. Only affects variables that are not of the straton driver.
Name of the configured profile in straton (e.g. STRATON, ProfDP).

More in the online help

RangeMax Double

Measuring range max.

Maximum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

RangeMin Double

Measuring range min.

Minimum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

ReadWrite Boolean

external read/write

External property for straton. Only affects variables, that are not of the straton driver.
Active: The value of the variable can be changed in straton. The variable definition cannot be changed in straton.
Inactive: The variable cannot be changed in straton.
Default: active.

More in the online help

Recourceslabel String

Resources label

Freely definable string.
Is not used within the control system, but is available in export files to allow an identification of the exorted values for management systems (e.g. ERP).

Read more in the online manual

Rema Long

Reaction matrix

Only available, if reaction matrix is active:
Selection of the reaction matrix that should be used for the variable.

Read more in the online manual

SBO Boolean

Select Before Operate

Active: Before the value of the variable is written to the hardware, the control system makes sure, that the variable in the hardware is ready for the action. (=Select before operate; SBO)
Inactive: The value of the variable is written to the hardware without a previous request. (=Direct execute)
Default: inactive.

ATTENTION: This function is only supported by the IEC drivers.

Read more in the online manual

SV_Act Boolean

Old and new value

Active: On setting the value of this variable the old value and the new value are logged in the Chronologic Event List (CEL).
Inactive: Only the new value is logged.
Default: inactive.

Read more in the online manual

SV_VBA Boolean

Setting values with VBA

Active: Setting the value of this variable in VBA macro is logged in the Chronologic Event List (CEL).
Inactive: Setting the value of this variable in a VBA macro is not logged.
Default: active.

Read more in the online manual

SetValueProtocol Long

Logging

All: All "set value" actions of this variable with dynamic elements and "set value" functions are logged in the Chronologic Event List (CEL).
Nothing: No "set value" actions are logged in the CEL.
Only with dyn. element: Only "set value" actions with dynamic elements are logged in the CEL.
Default: Only with dyn. element.

Read more in the online manual

SignalMax Double

Signal resolution max.

Maximum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

SignalMin Double

Signal resolution min.

Minimum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

Standby Boolean

Only read from standby

Active: The value of the variable is displayed from the standby server.
Inactive: The value of the variable is displayed from the server.
(only for hardware drivers)

Read more in the online manual

StringLength Long

String length

Only available for string variables:
Maximum number of characters the variable can contain.
Minimum: 0 characters.
Maximum: 65535 characters.
Default: 5 characters.

Read more in the online manual

Tagname String

Identification

Freely definable string for the identification of the variable or the datatype.

Example: Can be used instead of the variable name in the online language change, as the name cannot be switched.

Read more in the online manual

Unit String

Unit

Technical unit of the variable for display in the control system.
Maximum: 50 characters.
Default: empty.

Read more in the online manual

UpdatePriority Long

Priority

If the global update time in the driver configuration is not used, update rates for the different priority levels can be set there. Here a priority level is linked to the variable.

Read more in the online manual

UseMacro Boolean

Non linear value adjustment with macros

The non-linear value adjustment is used for variables, whose original value (PLC) can not be scaled to the control system value in a linear way.
Activ: PLC values are scaled to control system values in a non-linear way (with VBA macros).
After activating the property "Non-linear value adjustment" the VBA macros for the calculation have to be entered under "AdjustHardwareValue" and "AdjustZenOnValue".
Inactive: PLC values are scaled to control system values in a linear way.
Default: inactive.

Read more in the online manual

ValueMax Double

Max. set value

The maximum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

ValueMin Double

Min. set value

The minimum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

VarInASM Boolean

save in IPA database

Active: The alarms of this variable are available for the evaluation in the Industrial Performance Analyzer (IPA).
Inactive: The alarms of this variable are ignored for the evaluation in the Industrial Performance Analyzer.
Default: inactive.

ATTENTION: The Industrial Performance Analyzer is an optional module and has to be licensed, so that it can be used here.

Read more in the online manual

Vargroup String

external variable group

External property for straton. Only affects variables that are not of the straton32 driver.
Variable groups in straton ("Global" or "Retain" or empty).

More in the online help

Variable EditorTop

Name Type Description
AdjustHardware ZT_VBAMAKRO

AdjustHardwareValue

Only available, if non-linear value adjustment is active:
Macro is executed with every change of the raw value (PLC) to update the value in the control system.

Read more in the online manual

AdjustZenon ZT_VBAMAKRO

AdjustScadaValue

Only available, if non-linear value adjustment is active:
Macro is executed when setting a value in the control system to update the raw value (PLC).

Read more in the online manual

Adressparam String

ext. address parameters

External property for straton. Only affects variables that are not variables of the straton driver.
Profile properties in straton (like "embedded" or address parameters for Profibus).

More in the online help

AlarmDomain Long

Alarm area

Here the variable can be linked to an alarm area.

Read more in the online manual

AlarmPV0 ZT_VARIABLE

Alarm variable 1

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmPV1 ZT_VARIABLE

Alarm variable 2

Only available in SICAM 230.
Second variable for the picture alarm.

More in the online help

AlarmPV2 ZT_VARIABLE

Alarm variable 3

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmQuitPV ZT_VARIABLE

Acknowledgement variable

Whenever an alarm of this variable is acknowledged, the selected variable is set to the value defined under "Acknowledgement value".

Read more in the online manual

AlarmQuitPVValue Long

Acknowledgement value

Whenever an alarm of this variable is acknowledged, the variable selected under "Acknowledgement variable" is set to this value.

Read more in the online manual

Alignment Long

Alignment

Depending on the granularity of the driver the position of the variable within the offset.

For byte variables:
HiByte: High byte in the word offset.
LoByte: Low byte in the word offset.
HiWord-HiByte: High byte of the high word in the doubleword offset.
HiWord-LoByte: Low byte of the high word in the doubleword offset.
LoWord-HiByte: High byte of the low word in the doubleword offset.
LoWord-LoByte: Low byte of the low word in the doubleword offset.

For word variables:
HiWord: High word in the doubleword offset.
LoWord: Low word in the doubleword offset.

Read more in the online manual

AlternateValue Double

Alternate value

The alternate value is used, if the control system needs a value of the variable but no value is available.
This value is used to fill cyclic archives in times, when there was no connection to the hardware.
Additionally the variable can be set to the alternate value instead of the spontaneous value with the standard "Set value" box, the Recipegroup Manager (RGM) or the Report Generator.

Read more in the online manual

AlternateValueString String

String alternative value

The alternate string value is used, if the control system needs a value of the string variable but no value is available.
(e.g. to fill cyclic archives)

ATTENTION: This property is not available for language switching.

Read more in the online manual

AreaName ZT_String_REF Gets/Sets the alarm area of a variable.
ArraySizeOld Long

Array size

Only for compatibility reasons.

Read more in the online manual

BitAddr Long

Bit number

Number of the bit within the defined offset.
Minimum: 0.
Maximum: 65535.
Default: 0.

Read more in the online manual

CounterGroup Long

Counter group

Only available in SICAM 230.

DDEActive Boolean

DDE active

Active: The variable is available for other Windows applications.(e.g. Excel, Visual-Basic, etc.). Windows applications with DDE client functionality can thus use the variable values. The update time is 0.5 s.
Inactive: The variable is not availabe for other Windows applications.
Default: inactive.

Read more in the online manual

DataBlock Long

Data block

Number of the datablock.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Digits Long

Decimals

Number of decimals of the variable value for the display in the control system.
Minimum: 0.
Maximum: 5.
Default: 0.

Read more in the online manual

Driver Long

Driver

Driver for the variable; is selected on creating the variable and can be changed here lateron.

Read more in the online manual

ExternVisible Boolean

externally visible

External property for straton. Only affects variables, that are not of the straton driver.
Active: The variable is also visible in straton and can therefore be used in straton projects. The variable definition cannot be changed in straton. The value of the variable can be changed, though.
Inactive: The variable is not visible in straton.
Default: inactive.

ATTENTION: variable names for straton must meet the requirements of the IEC 61131-3, i.e. only numbers, letters (no umlauts) and underscores are allowed. In addition, the name must not begin with a number.
This also implies that structures and arrays are not visible from the outside, because they contain brackets and dots.

More in the online help

HDActive Boolean

HD active

Active: Variable values are stored on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.
Inactive: No variable values are stored.
Default: inactive.

HD data need 24 bytes of storage place per value, independent of the variable type. Beside the value the following information is stored:
- Time, when the value was read.
- Milliseconds when reading the value.
- Status of the value to correctly adapt elements.
- Counter for the unique identification of the value (spontaneous drivers).

Read more in the online manual

HDSize Long

Number of values

Only available, if harddisk data (HD) storage is active:
Number of values for the storage of online values on the harddisk (ring buffer) for the evaluation in the dynamic element "Trend element" or the export/import of the values.

Read more in the online manual

HDUpdate Float

Scan rate [s]

Only available, if harddisk data (HD) storage is active:
Interval time [in seconds] for the storage of on-line values on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.

Read more in the online manual

HystNeg Double

negative

The control system only realizes decreasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

HystPos Double

positive

The process control system only realizes increasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

ID_ComplexVariable Long With this property you have the opportunity to get/set the ID of a variable from a structure element. This ID is 0 when the variable has no structure datatype.
ID_DataTyp Long

Datatype

Datatype of the variable; is selected on creating the variable and can be changed here lateron.

ATTENTION: If the datatype is changed all the other properties of the variable have to be checked resp. modified.

Read more in the online manual

ID_DriverTyp Long

Driver object type

Depending on the selected driver on creating a variable the object type has to be selected and can be changed here lateron.
Siemens: datablock, marker, input/output.
Modbus: coil and holding register.

Read more in the online manual

InOut Boolean

Setting values active

Active: "Set value" actions for this variable are possible.
Inactive: This variable is read-only.
Default: active.

Read more in the online manual

InitialValue String

external init value

External property for straton. Only affects variables that are not of the straton driver.
Initial value of the variable in straton during cold start or warm start.
The input allowed here depends on the data type of the variable. For example, you can only use values without decimal places for whole-number variables. When using floating point variables, you have to use a dot as the decimal separator; a comma will not work
The control system does not validate your input here. This can lead to an error message in straton.

ATTENTION: When using variables of the internal driver, this property must have the same value as the initial value in the settings for internal variables.

More in the online help

IsKDAActiv Boolean

Recording type

Only available, if harddisk data (HD) storage is active:
Harddisk values (cyclic): Cyclic writing of the values on the harddisk
Postsorted values (RDA): The values are written blockwise by the driver on to the harddisk (post mortem mechanism).

Read more in the online manual

IsLocalAdjustHW Boolean With this property you have the opportunity to decide whether the "AdjustHardwareValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAdjustZenon Boolean With this property you have the opportunity to decide whether the "AdjustZenOnValue" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmDomain Boolean With this property you have the opportunity to decide whether the "Alarm area" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV0 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 1" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV1 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 2" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlarmPV2 Boolean With this property you have the opportunity to decide whether the "Alarm Variable 3" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAltValString Boolean With this property you have the opportunity to decide whether the "String alternative value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalAlternateValue Boolean With this property you have the opportunity to decide whether the "Alternate value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalArraySize Boolean With this property you have the opportunity to decide whether the "Array size" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalCounterGroup Boolean
IsLocalDDEaktiv Boolean With this property you have the opportunity to decide whether the "DDE active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalDigits Boolean With this property you have the opportunity to decide whether the "Decimals" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDActive Boolean With this property you have the opportunity to decide whether the "HD active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDSize Boolean With this property you have the opportunity to decide whether the "Number of HD values" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHDUpdate Boolean With this property you have the opportunity to decide whether the "HD scan rate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystNeg Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalHystPos Boolean With this property you have the opportunity to decide whether the "negative hysteresis" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalInOut Boolean With this property you have the opportunity to decide whether the "Setting values active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalKDAActiv Boolean With this property you have the opportunity to decide whether the "Recording type" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalLocking Boolean With this property you have the opportunity to decide whether the "Interlocking" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalMaxGradient Boolean
IsLocalNormalState Boolean
IsLocalNormalStateActive Boolean
IsLocalQuitPV Boolean With this property you have the opportunity to decide whether the "Acknowledgement variable" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalQuitValue Boolean With this property you have the opportunity to decide whether the "Acknowledgement value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMax Boolean With this property you have the opportunity to decide whether the "Maximum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRangeMin Boolean With this property you have the opportunity to decide whether the "Minimum measuring range" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRecLabel Boolean With this property you have the opportunity to decide whether the "Ressources label" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRema Boolean With this property you have the opportunity to decide whether the "Reaction matrix" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalRemaActiv Boolean With this property you have the opportunity to decide whether the "Reaction matrix active" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSBO Boolean With this property you have the opportunity to decide whether the "Select before operate" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMax Boolean With this property you have the opportunity to decide whether the "Maximum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalSignalMin Boolean With this property you have the opportunity to decide whether the "Minimum signal resolution" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStandby Boolean With this property you have the opportunity to decide whether the "Only read from standby" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalStingLength Boolean With this property you have the opportunity to decide whether the "String length" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalTagname Boolean With this property you have the opportunity to decide whether the "Identification" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUnit Boolean With this property you have the opportunity to decide whether the "Unit" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUpdatePriority Boolean With this property you have the opportunity to decide whether the "Priority of the driver connection" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalUseMacro Boolean With this property you have the opportunity to decide whether the "Non linear value adjustment with macros" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMax Boolean With this property you have the opportunity to decide whether the "Maximum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalValueMin Boolean With this property you have the opportunity to decide whether the "Minimum set value" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsLocalVarInASM Boolean With this property you have the opportunity to decide whether the "Save in IPA database" should be linked to the datatype or not.
FALSE = It should be linked, TRUE = It shouldn't be linked.
IsRemaActiv Boolean

Reaction matrix active

Active: Instead of limits a reaction matrix is used.
Inactive: Limits can be defined for the variable.
Default: inactive.

Read more in the online manual

IsSWProtokol Long
IsSW_Akt Boolean
IsSW_VBA Boolean
Limits SUBITEM

Limits

Properties for the limit or alarm behaviour of the variable.

Read more in the online manual

LockingName String With this property you have the opportunity to assign an interlocking via its name.

zElement.DynProperties("LockingName") = "Interlocking 1"

MaxGradient Long

Maximum gradient

Only available in SICAM 230.

Name String

Name

Unique name of the variable.

ATTENTION: This property is not available for language switching.

Read more in the online manual

NetAddr Long

Net address

Bus address or net address of the variable.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

NormalState Boolean

Normal value

Choose from the dropdown menu whether the normal value for this variable or data type should be On or Off. Available for variables and data types of the type BOOL, UINT and WORD for all drivers.

Default: On

NormalStateActive Boolean

Active

Allows the definition of a normal status for variables and data types of the type BOOL, UINT and WORD for all drivers.

Active: A normal status can be defined.

Default: inactive

Offset Long

Offset

Offset of the variable.
For linear addressing PLCs: the memory area.
For PLCs with a name resolution: the allocation address.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Profilename String

external profile name

External property for straton. Only affects variables that are not of the straton driver.
Name of the configured profile in straton (e.g. STRATON, ProfDP).

More in the online help

RangeMax Double

Measuring range max.

Maximum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

RangeMin Double

Measuring range min.

Minimum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

ReadWrite Boolean

external read/write

External property for straton. Only affects variables, that are not of the straton driver.
Active: The value of the variable can be changed in straton. The variable definition cannot be changed in straton.
Inactive: The variable cannot be changed in straton.
Default: active.

More in the online help

Recourceslabel String

Resources label

Freely definable string.
Is not used within the control system, but is available in export files to allow an identification of the exorted values for management systems (e.g. ERP).

Read more in the online manual

Rema Long

Reaction matrix

Only available, if reaction matrix is active:
Selection of the reaction matrix that should be used for the variable.

Read more in the online manual

SBO Boolean

Select Before Operate

Active: Before the value of the variable is written to the hardware, the control system makes sure, that the variable in the hardware is ready for the action. (=Select before operate; SBO)
Inactive: The value of the variable is written to the hardware without a previous request. (=Direct execute)
Default: inactive.

ATTENTION: This function is only supported by the IEC drivers.

Read more in the online manual

SV_Act Boolean

Old and new value

Active: On setting the value of this variable the old value and the new value are logged in the Chronologic Event List (CEL).
Inactive: Only the new value is logged.
Default: inactive.

Read more in the online manual

SV_VBA Boolean

Setting values with VBA

Active: Setting the value of this variable in VBA macro is logged in the Chronologic Event List (CEL).
Inactive: Setting the value of this variable in a VBA macro is not logged.
Default: active.

Read more in the online manual

SetValueProtocol Long

Logging

All: All "set value" actions of this variable with dynamic elements and "set value" functions are logged in the Chronologic Event List (CEL).
Nothing: No "set value" actions are logged in the CEL.
Only with dyn. element: Only "set value" actions with dynamic elements are logged in the CEL.
Default: Only with dyn. element.

Read more in the online manual

SignalMax Double

Signal resolution max.

Maximum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

SignalMin Double

Signal resolution min.

Minimum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

Standby Boolean

Only read from standby

Active: The value of the variable is displayed from the standby server.
Inactive: The value of the variable is displayed from the server.
(only for hardware drivers)

Read more in the online manual

StringLength Long

String length

Only available for string variables:
Maximum number of characters the variable can contain.
Minimum: 0 characters.
Maximum: 65535 characters.
Default: 5 characters.

Read more in the online manual

Tagname String

Identification

Freely definable string for the identification of the variable or the datatype.

Example: Can be used instead of the variable name in the online language change, as the name cannot be switched.

Read more in the online manual

Unit String

Unit

Technical unit of the variable for display in the control system.
Maximum: 50 characters.
Default: empty.

Read more in the online manual

UpdatePriority Long

Priority

If the global update time in the driver configuration is not used, update rates for the different priority levels can be set there. Here a priority level is linked to the variable.

Read more in the online manual

UseMacro Boolean

Non linear value adjustment with macros

The non-linear value adjustment is used for variables, whose original value (PLC) can not be scaled to the control system value in a linear way.
Activ: PLC values are scaled to control system values in a non-linear way (with VBA macros).
After activating the property "Non-linear value adjustment" the VBA macros for the calculation have to be entered under "AdjustHardwareValue" and "AdjustZenOnValue".
Inactive: PLC values are scaled to control system values in a linear way.
Default: inactive.

Read more in the online manual

ValueMax Double

Max. set value

The maximum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

ValueMin Double

Min. set value

The minimum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

VarInASM Boolean

save in IPA database

Active: The alarms of this variable are available for the evaluation in the Industrial Performance Analyzer (IPA).
Inactive: The alarms of this variable are ignored for the evaluation in the Industrial Performance Analyzer.
Default: inactive.

ATTENTION: The Industrial Performance Analyzer is an optional module and has to be licensed, so that it can be used here.

Read more in the online manual

Vargroup String

external variable group

External property for straton. Only affects variables that are not of the straton32 driver.
Variable groups in straton ("Global" or "Retain" or empty).

More in the online help

Variable RuntimeTop

Name Type Description
AdjustHardware ZT_VBAMAKRO

AdjustHardwareValue

Only available, if non-linear value adjustment is active:
Macro is executed with every change of the raw value (PLC) to update the value in the control system.

Read more in the online manual

AdjustZenon ZT_VBAMAKRO

AdjustScadaValue

Only available, if non-linear value adjustment is active:
Macro is executed when setting a value in the control system to update the raw value (PLC).

Read more in the online manual

Adressparam String

ext. address parameters

External property for straton. Only affects variables that are not variables of the straton driver.
Profile properties in straton (like "embedded" or address parameters for Profibus).

More in the online help

AlarmDomain Long

Alarm area

Here the variable can be linked to an alarm area.

Read more in the online manual

AlarmPV0 ZT_VARIABLE

Alarm variable 1

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmPV1 ZT_VARIABLE

Alarm variable 2

Only available in SICAM 230.
Second variable for the picture alarm.

More in the online help

AlarmPV2 ZT_VARIABLE

Alarm variable 3

Only available in SICAM 230.
First variable for the picture alarm.

More in the online help

AlarmQuitPV ZT_VARIABLE

Acknowledgement variable

Whenever an alarm of this variable is acknowledged, the selected variable is set to the value defined under "Acknowledgement value".

Read more in the online manual

AlarmQuitPVValue Long

Acknowledgement value

Whenever an alarm of this variable is acknowledged, the variable selected under "Acknowledgement variable" is set to this value.

Read more in the online manual

Alignment Long

Alignment

Depending on the granularity of the driver the position of the variable within the offset.

For byte variables:
HiByte: High byte in the word offset.
LoByte: Low byte in the word offset.
HiWord-HiByte: High byte of the high word in the doubleword offset.
HiWord-LoByte: Low byte of the high word in the doubleword offset.
LoWord-HiByte: High byte of the low word in the doubleword offset.
LoWord-LoByte: Low byte of the low word in the doubleword offset.

For word variables:
HiWord: High word in the doubleword offset.
LoWord: Low word in the doubleword offset.

Read more in the online manual

AlternateValue Double

Alternate value

The alternate value is used, if the control system needs a value of the variable but no value is available.
This value is used to fill cyclic archives in times, when there was no connection to the hardware.
Additionally the variable can be set to the alternate value instead of the spontaneous value with the standard "Set value" box, the Recipegroup Manager (RGM) or the Report Generator.

Read more in the online manual

AlternateValueString String

String alternative value

The alternate string value is used, if the control system needs a value of the string variable but no value is available.
(e.g. to fill cyclic archives)

ATTENTION: This property is not available for language switching.

Read more in the online manual

AreaName ZT_String_REF Gets/Sets the alarm area of a variable.
ArraySizeOld Long

Array size

Only for compatibility reasons.

Read more in the online manual

BitAddr Long

Bit number

Number of the bit within the defined offset.
Minimum: 0.
Maximum: 65535.
Default: 0.

Read more in the online manual

CounterGroup Long

Counter group

Only available in SICAM 230.

DDEActive Boolean

DDE active

Active: The variable is available for other Windows applications.(e.g. Excel, Visual-Basic, etc.). Windows applications with DDE client functionality can thus use the variable values. The update time is 0.5 s.
Inactive: The variable is not availabe for other Windows applications.
Default: inactive.

Read more in the online manual

DataBlock Long

Data block

Number of the datablock.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Digits Long

Decimals

Number of decimals of the variable value for the display in the control system.
Minimum: 0.
Maximum: 5.
Default: 0.

Read more in the online manual

Driver Long

Driver

Driver for the variable; is selected on creating the variable and can be changed here lateron.

Read more in the online manual

ExternVisible Boolean

externally visible

External property for straton. Only affects variables, that are not of the straton driver.
Active: The variable is also visible in straton and can therefore be used in straton projects. The variable definition cannot be changed in straton. The value of the variable can be changed, though.
Inactive: The variable is not visible in straton.
Default: inactive.

ATTENTION: variable names for straton must meet the requirements of the IEC 61131-3, i.e. only numbers, letters (no umlauts) and underscores are allowed. In addition, the name must not begin with a number.
This also implies that structures and arrays are not visible from the outside, because they contain brackets and dots.

More in the online help

HDActive Boolean

HD active

Active: Variable values are stored on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.
Inactive: No variable values are stored.
Default: inactive.

HD data need 24 bytes of storage place per value, independent of the variable type. Beside the value the following information is stored:
- Time, when the value was read.
- Milliseconds when reading the value.
- Status of the value to correctly adapt elements.
- Counter for the unique identification of the value (spontaneous drivers).

Read more in the online manual

HDSize Long

Number of values

Only available, if harddisk data (HD) storage is active:
Number of values for the storage of online values on the harddisk (ring buffer) for the evaluation in the dynamic element "Trend element" or the export/import of the values.

Read more in the online manual

HDUpdate Float

Scan rate [s]

Only available, if harddisk data (HD) storage is active:
Interval time [in seconds] for the storage of on-line values on the harddisk (ring buffer) for the evaluation in the dynamic element "trend element" or the export/import of the values.

Read more in the online manual

HystNeg Double

negative

The control system only realizes decreasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

HystPos Double

positive

The process control system only realizes increasing value changes of the variable, if the value change is higher than the defined hysteresis.
Default: 0.

Read more in the online manual

ID_ComplexVariable Long With this property you have the opportunity to get/set the ID of a variable from a structure element. This ID is 0 when the variable has no structure datatype.
ID_DataTyp Long

Datatype

Datatype of the variable; is selected on creating the variable and can be changed here lateron.

ATTENTION: If the datatype is changed all the other properties of the variable have to be checked resp. modified.

Read more in the online manual

ID_DriverTyp Long

Driver object type

Depending on the selected driver on creating a variable the object type has to be selected and can be changed here lateron.
Siemens: datablock, marker, input/output.
Modbus: coil and holding register.

Read more in the online manual

InOut Boolean

Setting values active

Active: "Set value" actions for this variable are possible.
Inactive: This variable is read-only.
Default: active.

Read more in the online manual

InitialValue String

external init value

External property for straton. Only affects variables that are not of the straton driver.
Initial value of the variable in straton during cold start or warm start.
The input allowed here depends on the data type of the variable. For example, you can only use values without decimal places for whole-number variables. When using floating point variables, you have to use a dot as the decimal separator; a comma will not work
The control system does not validate your input here. This can lead to an error message in straton.

ATTENTION: When using variables of the internal driver, this property must have the same value as the initial value in the settings for internal variables.

More in the online help

IsKDAActiv Boolean

Recording type

Only available, if harddisk data (HD) storage is active:
Harddisk values (cyclic): Cyclic writing of the values on the harddisk
Postsorted values (RDA): The values are written blockwise by the driver on to the harddisk (post mortem mechanism).

Read more in the online manual

IsRemaActiv Boolean

Reaction matrix active

Active: Instead of limits a reaction matrix is used.
Inactive: Limits can be defined for the variable.
Default: inactive.

Read more in the online manual

LastUpdateTime ZT_DateTIME This property returns the date and time when the value of a variable has been changed.
LastUpdateTimeMilliSeconds Long This property returns the update time in milliseconds.
Limits SUBITEM

Limits

Properties for the limit or alarm behaviour of the variable.

Read more in the online manual

LockingName String With this property you have the opportunity to assign an interlocking via its name.

zElement.DynProperties("LockingName") = "Interlocking 1"

MaxGradient Long

Maximum gradient

Only available in SICAM 230.

Name String

Name

Unique name of the variable.

ATTENTION: This property is not available for language switching.

Read more in the online manual

NetAddr Long

Net address

Bus address or net address of the variable.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

NormalState Boolean

Normal value

Choose from the dropdown menu whether the normal value for this variable or data type should be On or Off. Available for variables and data types of the type BOOL, UINT and WORD for all drivers.

Default: On

NormalStateActive Boolean

Active

Allows the definition of a normal status for variables and data types of the type BOOL, UINT and WORD for all drivers.

Active: A normal status can be defined.

Default: inactive

Offset Long

Offset

Offset of the variable.
For linear addressing PLCs: the memory area.
For PLCs with a name resolution: the allocation address.
Minimum: 0.
Maximum: 4294967295.
Default: 0.

Read more in the online manual

Profilename String

external profile name

External property for straton. Only affects variables that are not of the straton driver.
Name of the configured profile in straton (e.g. STRATON, ProfDP).

More in the online help

RangeMax Double

Measuring range max.

Maximum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

RangeMin Double

Measuring range min.

Minimum value of the variable in the control system.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

ReadWrite Boolean

external read/write

External property for straton. Only affects variables, that are not of the straton driver.
Active: The value of the variable can be changed in straton. The variable definition cannot be changed in straton.
Inactive: The variable cannot be changed in straton.
Default: active.

More in the online help

Recourceslabel String

Resources label

Freely definable string.
Is not used within the control system, but is available in export files to allow an identification of the exorted values for management systems (e.g. ERP).

Read more in the online manual

Rema Long

Reaction matrix

Only available, if reaction matrix is active:
Selection of the reaction matrix that should be used for the variable.

Read more in the online manual

SBO Boolean

Select Before Operate

Active: Before the value of the variable is written to the hardware, the control system makes sure, that the variable in the hardware is ready for the action. (=Select before operate; SBO)
Inactive: The value of the variable is written to the hardware without a previous request. (=Direct execute)
Default: inactive.

ATTENTION: This function is only supported by the IEC drivers.

Read more in the online manual

SV_Act Boolean

Old and new value

Active: On setting the value of this variable the old value and the new value are logged in the Chronologic Event List (CEL).
Inactive: Only the new value is logged.
Default: inactive.

Read more in the online manual

SV_VBA Boolean

Setting values with VBA

Active: Setting the value of this variable in VBA macro is logged in the Chronologic Event List (CEL).
Inactive: Setting the value of this variable in a VBA macro is not logged.
Default: active.

Read more in the online manual

SetValueProtocol Long

Logging

All: All "set value" actions of this variable with dynamic elements and "set value" functions are logged in the Chronologic Event List (CEL).
Nothing: No "set value" actions are logged in the CEL.
Only with dyn. element: Only "set value" actions with dynamic elements are logged in the CEL.
Default: Only with dyn. element.

Read more in the online manual

SignalMax Double

Signal resolution max.

Maximum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

SignalMin Double

Signal resolution min.

Minimum value of the variable in the PLC.
Unless defined differently in Value adjustment non-linear, the raw value of the variable (signal resolution) will always be converted to the measuring range on a linear basis (for the use in the control system). All further numerical value inputs for the variable in the Editor and the Runtime will relate to the measuring range (e.g. definition of limits, set value limits, representation area, setpoint inputs, ...).

More in the online help

Standby Boolean

Only read from standby

Active: The value of the variable is displayed from the standby server.
Inactive: The value of the variable is displayed from the server.
(only for hardware drivers)

Read more in the online manual

StatusString String This property returns the status of a variable.
StatusValue VT_UI8 This property returns the status of a variable as a value.
StringLength Long

String length

Only available for string variables:
Maximum number of characters the variable can contain.
Minimum: 0 characters.
Maximum: 65535 characters.
Default: 5 characters.

Read more in the online manual

Tagname String

Identification

Freely definable string for the identification of the variable or the datatype.

Example: Can be used instead of the variable name in the online language change, as the name cannot be switched.

Read more in the online manual

Unit String

Unit

Technical unit of the variable for display in the control system.
Maximum: 50 characters.
Default: empty.

Read more in the online manual

UpdatePriority Long

Priority

If the global update time in the driver configuration is not used, update rates for the different priority levels can be set there. Here a priority level is linked to the variable.

Read more in the online manual

UseMacro Boolean

Non linear value adjustment with macros

The non-linear value adjustment is used for variables, whose original value (PLC) can not be scaled to the control system value in a linear way.
Activ: PLC values are scaled to control system values in a non-linear way (with VBA macros).
After activating the property "Non-linear value adjustment" the VBA macros for the calculation have to be entered under "AdjustHardwareValue" and "AdjustZenOnValue".
Inactive: PLC values are scaled to control system values in a linear way.
Default: inactive.

Read more in the online manual

UserValue VT_Variant
Value VT_Variant
ValueMax Double

Max. set value

The maximum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

ValueMin Double

Min. set value

The minimum set here for "set value" actions can be taken over in dynamic elements instead of setting it there seperately.
This is recommended, if the measuring range of the variable might change lateron. So these changes can be made here for once and not seperately in every element.

Read more in the online manual

VarInASM Boolean

save in IPA database

Active: The alarms of this variable are available for the evaluation in the Industrial Performance Analyzer (IPA).
Inactive: The alarms of this variable are ignored for the evaluation in the Industrial Performance Analyzer.
Default: inactive.

ATTENTION: The Industrial Performance Analyzer is an optional module and has to be licensed, so that it can be used here.

Read more in the online manual

Vargroup String

external variable group

External property for straton. Only affects variables that are not of the straton32 driver.
Variable groups in straton ("Global" or "Retain" or empty).

More in the online help

Samples:Top



Sub CreateVariable()

Dim zVariables As Variables 'Object from type Variables
Dim zVariable As Variable 'Child object from type Variables
Dim zDrivers As Drivers 'Object from type Drivers
Dim zVarTypes As VarTypes 'Object from type VarTypes
Dim zEdLimit As EdLimit 'Object from type EdLimit

'Fill the objects
Set zVariables = MyWorkspace.ActiveDocument.Variables
Set zDrivers = MyWorkspace.ActiveDocument.Drivers
Set zVarTypes = MyWorkspace.ActiveDocument.VarTypes

'Create a "intern driver" variable called "TestVariable" with object type "internal variable" and datatype "INT"
Set zVariable = zVariables.CreateVar("TestVariable", zDrivers.Item(0), 33, zVarTypes.Item("INT"))
'Create a limit at the "TestVariable"
zVariable.CreateEdLimit

'Select the first limit of the variable
Set zEdLimit = zVariable.EDLimitItem(0)
'Set the limit active
zEdLimit.Active = True
'Set limit text
zEdLimit.Text = "Limit reached"
'Set limit value to 10
zEdLimit.LimitValue = 10
'Set the limit as maximum
zEdLimit.IsMax = True
'Set the limit as alarm
zEdLimit.Alarm = True
'Limit should be recognized in the CEL
zEdLimit.Cel = True

Call CreateArrayVariable

End Sub

Sub CreateArrayVariable()

Dim zVariables As Variables 'Object from type Variables
Dim zVariable As Variable 'Child object from type Variables
Dim zArrEl As Variable 'Object from type Variables
Dim zEdLimit As EdLimit 'Object from type EdLimit
Dim i As Integer

'Fill the objects
Set zVariables = MyWorkspace.ActiveDocument.Variables
Set zDrivers = MyWorkspace.ActiveDocument.Drivers
Set zVarTypes = MyWorkspace.ActiveDocument.VarTypes

'Create a "intern driver" array variable called "ArrayVar" from object type "internal variable", datatype "INT", start at index 1,
'dimension of 5 and automatic addressing
Set zVariable = zVariables.CreateArrayVar("ArrayVar", zDrivers.Item(0), 33, zVarTypes.Item("INT"), 1, 5, 0, 0, True, False, False)

'Activate all array elements
For i = 0 To 4
	zVariable.ActivateSubItem (i)
Next i

'Read the first array element
Set zArrEl = zVariable.SubItem(0)
'Create a limit at the array element
zArrEl.CreateEdLimit

'Select the first limit of the variable
Set zEdLimit = zArrEl.EDLimitItem(0)
'Set the limit active
zEdLimit.Active = True
'Set limit text
zEdLimit.Text = "Limit reached"
'Set limit value to 10
zEdLimit.LimitValue = 10
'Set the limit as maximum
zEdLimit.IsMax = True
'Set the limit as alarm
zEdLimit.Alarm = True
'Limit should be recognized in the CEL
zEdLimit.Cel = True

End Sub