$RlcFile

From m204wiki
Revision as of 13:18, 20 April 2013 by Alex (talk | contribs) (Automatically generated page update)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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