_online

Attribute (neutral) Bit number of the 64bit status bits Type Read/Write Access Description
_active 0 bool READ+WRITE The _active config is set active or inactive.
_alert_range uint READ+WRITE Sets the alert range of a an alert handling explicitly instead of evaluating the original value first.

Example:

alert ranges:

<0: Alert "Low",

>0: Alert "High",

==0: Normal.

dpSet(x.:_original.._value", 0, "x.:_original.._alert_range", 2) sets the original value to 0 and triggers the alert "High". Thus, the alert range is set explicitly. Normally the value 0 would trigger a "low" alert. The alert range can be set for all (integer, float and bool) alerts.
_aut_default 2 bool READ A default value that is set automatically by the system because a value was invalid, for example, when a value range was violated (_pv_range attribute or _u_range attribute).
_aut_inv 6 bool READ+WRITE An invalid value set by an interface driver. An invalid bit can, for example, be received from the PLC or the driver can convert a none raw value to an ing.value (that can be read by WinCC_OA). Since a none raw value was converted, the invalid bit is set.
_bad virtual == _invalid || _out_prange bool READ The value is invalid. this means that either the original value is invalid or the WinCC OA value range was violated.
_comp_corr 14 bool READ The compression is based on correction values.
Note:
If you query this attribute, the system will always return FALSE since this attribute is only set for a query of historical (archived) values (_offline config).
_comp_inv 16 bool READ The compression is based on invalid values.
Note:
If you query this attribute, the system will always return FALSE since this attribute is only set for a query of historical (archived) values (_offline config).
_compr 13 bool READ The archived value was compressed in the database. The archiving/compression is used.
Note:
If you query this attribute, the system will always return FALSE since this attribute is only set for a query of archived values (_offline config).
_corr 12 bool READ A correction value.
Note:
If you query this attribute, the system will always return FALSE since this attribute is only set for a query of historical (archived) values (_offline config).
_corr_add 15 bool READ An additional correction value.
Note:
If you query this attribute, the system will always return FALSE since this attribute is only set for a query of historical (archived) values (_offline config).
_default virtual == _exp_default || _aut_default bool READ A default value was set. The value was either automatically set by the system or explicitly by a user.
_default_bad 8 bool READ An invalid default value.
_exp_default 1 bool READ+WRITE A default value was explicitly set by a user in the PARA module.
_exp_inv 5 bool READ+WRITE A value was explicitly set invalid by a user in the PARA module.
_from_GI 9 bool READ+WRITE The value was set during a general query. A driver executes a general query when it starts or after a redundancy switch in order to receive the last value. Values of a general query are not smoothed. This attribute is only set for the values of a general query.

If a value is received spontaneously from the PLC or polled by a driver, neither _from_GI nor _from_SI is set.
_from_SI 10 bool READ+WRITE The value was set during an individual query. This means that the user queries the value explicitly by using the datapoint element _DriverCommon.SQ.

If a value is received spontaneously from the PLC or polled by a driver, neither _from_GI nor _from_SI is set.
_invalid virtual == _exp_inv || _aut_inv || _stime_inv bool READ An original value is invalid. The value was set invalid either automatically by the system or explicitly by the user or the source time of the value is invalid.
_last_value_storage_off 19 bool READ+WRITE This attribute deactivates the last value storage.

Definition of the "last value storage":

Every value change of each datapoint element is stored in the RAIMA / SQLite last value database by default - a new value overwrites the previous value. Time of change, value, status bit, user and manager are stored.

By setting this attribute, the storage of the last value in the RAIMA / SQLite database is deactivated. This means that a value of a data point element is not saved in case of a value change.

Example:

When the value of a datapoint element is set to 10 and the last value storage is deactivated afterwards, then the datapoint element is initialized with the value 10 (last stored value in the database) after every WinCC OA start independent of the new value of the datapoint element before the initialization.

Note:
Even if the last value storage is deactivated, the value can be saved historically by using the archive configs.
CAUTION:
When the saved value lies inside the alert range when switching off the last value storage of a datapoint, an alert is triggered with the time stamp of the switch off of the last value storage when the WinCC OA project is started. This alert is reported as "dead alert". Do not activate the last value storage by using a current value that triggers an alert. Note this also when changing the alert limits.
_manager int READ The manager which set the value.
_offline_bad virtual == ! (_corr || !_online_bad || (_compr && !comp_corr) bool READ The valid offline value is invalid.

A correction value was not set, the online value (the value all modules within WinCC OA are using) is invalid and the value is not compressed or the compression is based on correction values.
_online_bad

7

virtual == _default ? _default_bad : _bad

 bool READ A default value was set and the valid default value is bad.
_out_of_service 11 bool READ A driver can set this attribute when an associated component is out of service. This attribute is not currently used by the WinCC OA drivers.
_out_prange 3 bool READ The WinCC OA value range was violated.
_out_range 4 bool READ If the attribute "_Out_of_range" is TRUE, the value from the PLC could not be converted into a WinCC OA datapoint element.

If the bit _out_range is set, the bit _out_prange is also automatically set.
_pa_quality int (8Bits) READ An additional quality information that a driver can set. This attribute is not currently used by the WinCC OA drivers.
_quality_code int (16 Bits) READ Currently not used.
_status bit32 READ+WRITE A bit pattern for status bits. The bit pattern consists of:

- Bits 0-23: internal status bits

The internal status bits contain system information and cannot be changed by the user. See chapter _original (Original attributes).

- Bits 24-31: User bits

The user-defined bits serve for different purposes. In case of drivers for example, the quality information is mapped to these user bits.

The user bits and bytes overlap one another.

This means that 1 byte overwrites the bits 1-8 etc.

Note:
The _status consists of several bits that are writable. You cannot, however, write to the whole bit pattern at once.
_status64 bit64 READ A bit pattern for all status bits

- Bits 0-23: internal status bits

The internal status bits contain system information and cannot be changed by the user. See chapter _original (Original attributes).

Bits 24-55: Userbits

The 32 user-defined bits serve for different purposes. In case of drivers for example, the quality information is mapped to these user bits.

The user bits, bytes and words overlap one another.

This means that 1 byte overwrites the bits 1-8 etc. See chapter _original (Original attributes).

Note:
The _status64 consists of several bits that are writable. You cannot, however, write to the whole bit pattern at once.
_stime time READ The source time. The time that specifies when a value was changed the last time.
_stime_inv 17 bool READ The new source time is invalid. The time is invalid, for example, because the point in time is before the current source time.
_text langString READ Current specified alert text such as "alert" of a datapoint. In the PARA module the _text attribute is the "Came text" of an alert handling.
Restriction:
The historical values of the attribute _text cannot be read.
_transition 18 bool READ+WRITE The driver sent a value to the PLC but didn't receive a current value yet. Therefore, the command is still processed. Default: FALSE.
_type int READ The config type of a datapoint element.

The value of the attribute _type is 0 when a datapoint element was deleted or 1 when the DPE exists. Note, however, that 0 is returned only when a query for the _original..type attribute exists and the DPE is deleted.
_uncertain 22 bool READ This attribute is set to TRUE for poll on use peripheral addresses when these are not currently polled.
_user int READ The logged in user as the value was set.
_userbit1, ..., _userbit32 24-55 byte READ+WRITE The user-defined user bit 1-32.

The user-defined bits serve for different purposes. In case of drivers for example, the quality information is mapped to these user bits.

The user bits, bytes and words overlap one another.

This means that 1 byte overwrites the bits 1-8 etc. See also chapter _original (Original attributes).
_userbyte1 24 byte READ+WRITE The user-defined user byte 1. The _userbyte1 overwrites the user bits 1-8.
_userbyte2 32 byte READ+WRITE The user-defined user byte2. The _userbyte2 overwrites the user bits 9- 16.
_userbyte3 40 byte READ+WRITE The user-defined user byte 3. The _userbyte3 overwrites the user bits 17- 24.
_userbyte4 48 byte READ+WRITE The user-defined status byte 4. The _userbyte4 overwrites the user bits 25-32.
_userword1 24 16bit word READ+WRITE The user-defined status word 1. The _userword1 overwrites the user bits 1-16.
_userword2 40 16bit word READ+WRITE The user-defined user word 2. The _userword2 overwrites the user bits 17-32.
_userbits 24 bit READ+WRITE The user-defined user bits (all 32 bits).
Note:
When setting a user bit, it is also necessary to set the value of the DPE, see example at the end of the chapter.
_value var READ+WRITE The original value of a datapoint.

UserBits

This example shows you how to set the original value as well as the status of data point TestDP_1. The original value is set to 12 and user bits 2, 4 and 8 are set to TRUE. Refer to _original (Original attributes) for further information.

main()
{
  dpSet("TestDP_1.element:_original.._value",12,
  "TestDP_1.element:_original.._userbit2", TRUE,
  "TestDP_1.element:_original.._userbit4", TRUE,
  "TestDP_1.element:_original.._userbit8", TRUE);
}