FILE-NAME attribute

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/Writeable

Applies to: COMPILER system handle, FILE-INFO system handle, Procedure object 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 (?).

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, 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. See OpenEdge Development: Internationalizing Applications for more information about Unicode and code pages.

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, 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. For more information on remote procedures, see OpenEdge Application Server: Developing AppServer Applications.

The FILE-NAME attribute of the COMPILER handle and procedure handles is read only.