Mlarocca: Mlarocca moved page $RLCFILE to $RlcFile: Lower case change

2014-07-29T14:23:28Z

Mlarocca moved page $RLCFILE to $RlcFile: Lower case change

← Older revision	Revision as of 14:23, 29 July 2014
(No difference)

Alex: Automatically generated page update

2013-04-20T13:18:14Z

Automatically generated page update

New page

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 <var class="term">filename AT location</var>). 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

[[Category:SOUL $functions]]

$RlcFile - Revision history

Mlarocca: Mlarocca moved page $RLCFILE to $RlcFile: Lower case change

Alex: Automatically generated page update