_original

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 unint 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+WRITE 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+WRITE

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+WRITE

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+WRITE

The value was condensed or compressed in the History DB & RAIMA 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 historical (archived) values (_offline config).

_corr 12 bool READ+WRITE

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+WRITE

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+WRITE 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 data point element is stored in the RAIMA 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 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 data point element is set to 10 and the last value storage is deactivated afterwards, then the data point 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 data point 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 data point, 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 virtual == _default ? _default_bad : _bad bool READ A default value was set and the valid default value is bad.
_out_of_service bool READ+WRITE 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+WRITE The WinCC OA value range was violated.
_out_range 4 bool READ+WRITE

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 data point. In the PARA module the _text attribute is the "Came text" of an alert handling.

CAUTION!

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+WRITE 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 bool 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 unsigned READ+WRITE The user-defined status word 1. The _userword1 overwrites the user bits 1-16.
_userword2 40 unsigned READ+WRITE The user-defined user word 2. The _userword2 overwrites the user bits 17-32.
_userbits 24 bit32 READ+WRITE The user-defined user bits (all 32 bits).
_value var READ+WRITE The original value of a datapoint.
_value_changed 20 bool READ+WRITE

The original value has changed (TRUE). Note that the first value that is set on a data point element is not taken into account.

_value_changed is only valid for simple data types such as numbers, bits, times or strings, but not for bit32, dpIdentifiers, blobs, structs, dyns or langStrings.

_value_up 21 bool READ+WRITE

The original value is increasing (TRUE). Note that the first value that is set on a data point element is not taken into account.

If the previous value equals to the current value, the value of the _value_up is also TRUE.

The _value_up attribute is only valid for simple data types such as numbers, bits, times or strings, but not for bit32, dpIdentifiers, blobs, structs, dyns or langStrings.

Example

The following lines show how to set the original value and status of the datapoint TestDP_1. The original value is set to 12 and the user bits 2, 4 and 8 are set to TRUE.

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);
}

For more information, see chapter Module PARA - _original (original attributes).