View source for $Curfile

<p>
The <var>$Curfile</var> function returns the name of the file from which the current record has been selected. If the file is remote, <var>$Curfile</var> also returns the location of the file (in the form <var class="term">filename AT location</var>). <var>$Curfile</var> takes no arguments. </p>
<p>
You can use <var>$Curfile</var> in two places:</p>
<ul>
<li>In arithmetic and <var>Print</var> specifications within a record loop </li>

<li>In an <var>In</var> clause to override a default file or group in a <var>[[Data_maintenance#STORE_RECORD_statement|Store Record]]</var> statement </li>
</ul>
<p>
See [[Files, groups, and reference context#$Curfile and $Update functions|$Curfile and $Update functions]] for a discussion of default files and for examples of requests using <var>$Curfile</var>. </p>
<p>
You cannot use an <var>In</var> clause that includes both <var>Member</var> and <var>$Curfile</var>. See [[Files, groups, and reference context#IN GROUP MEMBER clause|IN GROUP MEMBER clause]] for more information about the <var>In Group Member</var>  clause.   </p>
 
==See also==
<ul>
<li>The <var>[[CURFILE parameter|CURFILE]]</var> parameter.
<p class="note"><b>Note:</b> It is recommended that you use <code>$Curfile</code> rather than <code>$View('CURFILE')</code>; in some circumstances <var>$Curfile</var> returns more accurate information than the <var>CURFILE</var> parameter.</p></li>

<li>The <var>[[DEFCNTX parameter|DEFCNTX]]</var> parameter (which is quite similar to the <var>CURFILE</var> parameter but provides more information and with more accuracy), and see the related <var>[[APDFCNTX parameter|APDFCNTX]]</var> parameter. </li>

<li>The <var>[[DEFAULT command|DEFAULT]]</var> and <var>[[OPEN FILE command|OPEN]]</var> commands, which reset the file/group context. </li>

<li>The <var>[[OPENC command|OPENC</var>]] command, which does <b>not</b> reset the file/group context.</li>

<li>The <var>[[CLOSE command|CLOSE</var>]] command, which might reset the file/group context. </li>
</ul>

[[Category:SOUL $functions]]