This Event will be raised before the Insert of RecRef record, from TargetTable table, as requested by SourcePeer Peer
The subscriber code can modify RecRef (for example, modifying a field); the inserted record will match to RecRef.
If Subscriber code set Handled to TRUE, Sprinkler will assume theat the operation has been done by the Subscriber; Sprinkler execution will continue raising OnAfterSpkInsertRecord Event.
If Subscriber code set ErrorMessage different from empty string, the record will NOT be inserted, and corresponding Entry will be moved into Data Distribution Import Error table, with Error code I-EVENTERR and Error Message corresponding to ErrorMessage. WARNING: Sprinkler operations will continue to next Entry.
If Subscriber code set PanicButton to TRUE, Sprinkler operations will be stopped: the actual Entry will stay in Inbox, and ErrorMessage will be logged into Sprinkler Log. To restart Sprinkler activity it is needed to correct the error, or delete the Entry from Inbox table; in both cases, Sprinkler will restart in one minute.