7.5.2 C$FILEINFO

C$FILEINFO retrieves operating system information for the named file. The syntax of C$FILEINFO is:

CALL "C$FILEINFO"
 USING FILE-NAME, FILE-INFO,
 GIVING STATUS-CODE

There are no restrictions on the use of C$FILEINFO. Note, however, that STATUS-CODE holds a zero ("0") if successful, a one ("1") if the file does not exist or is not a regular disk file, and a two ("2") if there is a network error (for example, AcuServer is not running).

FILE_PREFIX is not used to search for FILE-NAME. A full path name to the file, including remote name notation, must be hard coded in the function call. A more portable solution is to use the ACCEPT FROM ENVIRONMENT statement to get pathnames during program execution. See Appendix H of the ACUCOBOL-GT documentation.