The name of the file associated with a handle. Returns the empty string for a Web service procedure.
The FILE-NAME attribute of the COMPILER handle is maintained only for backward compatibility. Use the GET-FILE-NAME( ) method, instead.
Data type: CHARACTER
Access: Readable/Writable
Applies to: COMPILER system handle, FILE-INFO system handle, Procedure object handle, PROFILER system handle, RCODE-INFO handle, SOURCE-PROCEDURE system handle, TARGET-PROCEDURE system handle, THIS-PROCEDURE system handle
The FILE-NAME attribute of the COMPILER handle is the name of the source file from the preceding compilation. If no error occurred during the preceding compilation, FILE-NAME assumes the unknown value (?).
For the PROFILER handle, FILE-NAME is the file into which the profiling data is written after the raw recorded data is analyzed. The file name must be set before data can be stored. The default value is the unknown value (?).
The FILE-NAME attribute of the FILE-INFO or RCODE-INFO handle is the name of the file used by subsequent references to the handle. You can specify the filename with a .p, .r, or no extension. If you set FILE-NAME to a relative pathname, then the AVM searches the PROPATH to find the file. Otherwise, the AVM looks for the file specified by the absolute pathname. When used with FILE-INFO, the filename can contain Unicode characters. When used with RCODE-INFO, the filename cannot contain characters outside of the non-Unicode code page. For more information about Unicode and code pages, see Internationalize ABL Applications.
The FILE-NAME attribute of a procedure handle is the pathname of the procedure file that contains the procedure associated with the handle. If the procedure file is specified by the Startup Procedure (-p) parameter, then the attribute contains the full pathname of the file. Otherwise, it contains the pathname exactly as specified in the RUN statement that invoked it. The procedure can be local or remote.
The FILE-NAME attribute of the COMPILER handle and procedure handle is read only.