S

S — a reason for data change generated by the execution of dfaddreason

Synopsis

Content model

S ::=
(V?, T?)

Attributes

NameTypeDefaultDescription
frCDATANone

The id of the unique history element (HN) during which this item was recorded.

cEnumeration:
0=fail
1=success
2=success, but value truncated
None

The completion status of the action, or function during which this item was recorded. The only time that a status of "failure" (code 0) is produced is when the database server is found to be unavailable. Otherwise, a status of success (codes 1 or 2) is produced.

Description

Any reasons for data change generated by the dfaddreason function during the execution of an edit check are recorded in a S element.

The V element identifies the variable by name to which the reason for data change was added, even if it is the current variable. The T element contains the text of the reason for data change. This text matches the input reason text supplied by the programmer in the dfaddreason function call.

A S element does not imply that a reason for data change was added to the database, simply that one would have been added if the APPLY element had allowed data changes.

Processing Expectations

The history element that records which batch execution generated this element can be determined by matching the values of the fr attribute and the fd attribute.

Parents

These elements contain S: E

Children

The following elements occur in S: V, T

Examples

Example 6.90. A reason for data change added to the RACE variable

<S fr='1' c='1'><V n='RACE'/>
<T>previous response was obscured on the sent CRF</T></S>