BBjTriggerData::getExpectedDiskData

Description

In BBj 6.0 and higher and in an Update Trigger, this method returns the expected record value currently on disk before the update occurs. The expected disk data must match the actual data on disk or an error is generated when the file system attempts to update the record on disk.

This value is empty for Triggers fired by a WRITE RECORD call in the language. The value is only relevant during SQL UPDATE statements and calls to the update() methods on JLIB FilePosition instances.

Syntax

Return Value

Method

boolean

getExpectedDiskData()

Parameters

None.

Return Values

Returns the String passed in as the expected disk data.

Remarks

If there is a Read Trigger that manipulates the read buffer, it is likely the developer will need to reverse the operation on the expectedDiskData.

Example

REM Get the Trigger object from the BBj File System
    td! = BBjAPI().getFileSystem().getTriggerData()

REM Get the expected disk data.
    data$ = td!.getExpectedDiskData()

See Also

BBjAPI

BBjTriggerData

ObjectVariables

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.