C$FULLNAME

The C$FULLNAME library routine retrieves a file's full path. The runtime Framework follows the rules described in File names interpretation to resolve the name of the file.

Syntax:

CALL "C$FULLNAME" USING fileName                          fullName                          [fileInfo]                   GIVING returnCode

Parameters:

fileName	PIC X(n)	Specifies the name of the file. This should either be a full path name or a name relative to the current directory.
fullName	PIC X(n)	Receives the full path of fileName.
fileInfo	Group Item	Receives the file information. It must have the following structure:   01 fileInfo.    03 fileSize    PIC X(8) COMP-X.    03 fileDate    PIC 9(8) COMP-X.    03 fileTime    PIC 9(8) COMP-X.   fileSize Size of the file.   fileDate Date of the file, in YYYYMMDD format.   fileTime Time of the file.

Return code:

returnCode can be any numeric data item and provides additional information:

0	Operation successful, file found.
1	An error occurred, file not found.

Examples:

Example - Get the full absolute path to any file

call "c$fullname" using "customers.dat" fullname display fullname *> The value displayed could be : c:\myapp\data\customers.dat