$RlcFile: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
 
m (Mlarocca moved page $RLCFILE to $RlcFile: Lower case change)
 
(No difference)

Latest revision as of 14:23, 29 July 2014

The $RLCFILE function returns the name of the file in which the last record locking conflict occurred. If the file is remote, $RLCFILE also returns the location of the file (in the form filename AT location). This function is most useful when used within an ON FIND CONFLICT or ON RECORD LOCKING CONFLICT unit.

The $RLCFILE function takes no arguments. At the beginning of a request, $RLCFILE is set to null values. After a record locking conflict occurs, $RLCFILE returns the name of the conflicting file.

Example

This request prints the name of the file that invokes the ON RECORD LOCKING CONFLICT unit:

BEGIN ON RECORD LOCKING CONFLICT PRINT 'UNABLE TO COMPLETE' PRINT 'CONFLICT OCCURING IN FILE = ' WITH $RLCFILE END ON GET.NAME: FOR EACH RECORD WHERE - FULLNAME IS LIKE 'JOHNST*' CHANGE AGENT TO GOODRICH END FOR END