_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 | 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 | 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 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 |
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 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. |
_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 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 | 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). |
_value | var | READ+WRITE | The original value of a datapoint. |
Example
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 Module PARA - Data point configs - _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);
}