C$FSFULLNAME

The C$FSFULLNAME library routine retrieves an indexed file's full path. The runtime Framework takes advantage of the current file system native functions to check for file existence and obtain its full path.

Syntax:

CALL "C$FSFULLNAME" USING fileName                             fullName                     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.   If the file prefix includes paths starting with "isf://" and the file is found on the specified File Server, a name in the form "isf://servername[:port]:/path/to/file" is returned. See The ISF protocol for more information.
fullName	PIC X(n)	Receives the full path of fileName.

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 an indexed file

call "c$fsfullname" using "customers" fsfullname display fsfullname   *> The value displayed could be : c:\myapp\data\customers *> This value is possible if for instance, the c:\myapp\data *> path is included in the iscobol.file.prefix runtime property