ERROR-STRING attribute

An arbitrary string value associated with a buffer or temp-table object that provides descriptive information about an error on that object.

Data type: CHARACTER

Access: Readable/Writable

Applies to: Buffer object handle, Temp-table object handle

Setting the attribute does not in any way signal an error condition to ABL. The AVM does not inspect this string, or take action based on its value.

The AVM automatically clears this attribute by setting its value to the empty string ("") when one of the following occurs:

The FILL( ) method is used on any ProDataSet object containing a temp-table, on one of its member temp-table objects, or on a parent buffer that cascades down through that temp-table object.
The EMPTY-TEMP-TABLE( ) method is used on a temp-table object buffer.
You set the ERROR-STRING attribute, for the temp-table object, to the empty string ("").

The number of characters in this string is limited to 3K.

Note: The ERROR-STRING attribute is effective only if a before-table is NO-UNDO during a data source update. If the before-table is UNDO, the ERROR-STRING attribute is lost.