# SYSTEMPSQLATOMICS: Data Dictionary System PSQL atomic values Named atomic values of the session (dbms_atomic), with their kind, size and contention statistics. Live session state rather than a log: the values are gone when the session ends, so a script wanting an audit trail past its session writes one itself. The accumulated text and the elements of a list are deliberately not shown; they are readable from the script through get_text and elements_text. - Catalog: `DataDictionary` - Schema: `Invantive` - Alias: `pat` - Label: System PSQL atomic values This is a read-only view. The Data Dictionary API may not support changing the data or the Invantive UniversalSQL driver for Data Dictionary does not cover it. In the latter case, please use the table NativePlatformScalarRequests to upload data to the Data Dictionary API. ## View Columns The columns of the view `SYSTEMPSQLATOMICS` are shown below. Each column has an SQL data type. | Name | Data Type | Label | Required | Documentation | |---|:---:|---|:---:|---| | `CONTENDED_COUNT` | `int64` | Contended count | ☑ | Number of changes which had to wait for the session registry monitor. Zero means the value costs nothing. | | `CREATED_UTC` | `datetime` | Created (UTC) | ☑ | Moment the name came into being. | | `ELEMENT_COUNT` | `int64` | Element count | ☐ | Number of elements in a list, or number of appends to a text. Empty for the NUMBER kind. | | `KIND` | `varchar2` | Kind | ☑ | Kind of the value, fixed when the name was created: NUMBER, TEXT or LIST OF TEXT. | | `LAST_MODIFIED_BY_INSTANCE` | `varchar2` | Last modified by | ☐ | Description of the worker frame which last changed the value: a parallel branch, a parallel loop worker or the main frame. | | `LAST_MODIFIED_UTC` | `datetime` | Last modified (UTC) | ☐ | Moment the value was last changed. | | `NAME` | `varchar2` | Name | ☑ | Name of the atomic value (dbms_atomic). | | `NUMBER_VALUE` | `numeric` | Value | ☐ | Current value, for the NUMBER kind. Empty for the other kinds. | | `OPERATION_COUNT` | `int64` | Operation count | ☑ | Number of times the value was changed. Reads are not counted, so selecting this view does not change what it reports. | | `TOTAL_LENGTH` | `int64` | Total length | ☐ | Number of characters accumulated. Reported instead of the content itself: a value built by a script can hold anything the script could compute, so the content is readable only from the script, through get_text and elements_text. | | `WAIT_DURATION_MS` | `double` | Wait duration (ms) | ☑ | Total time changes of this value spent waiting for the session registry monitor. The count says how often the value was contended; this says what it cost. One monitor guards the whole session, so this is the wait experienced by operations on this name rather than necessarily the wait caused by them. |