FINFO Function

Returns the value of a file information item.

Category:	External Files
Restriction:	This function is not valid on the CAS server.
Note:	FINFO returns the value of a system-dependent information item for an external file. FINFO returns a blank if the value given for information-item is invalid.

Table of Contents

Syntax

FINFO(file-id, information-item)

Required Arguments

file-id

is a numeric constant, variable, or expression that specifies the identifier that was assigned when the file was opened, generally by the FOPEN function.

information-item

is a character constant, variable, or expression that specifies the name of the file information item to be retrieved.

Create Time: ddmmmyyyy:hh:mm:ss

Note: The Create Time date/time information item is localized to the site's locale. The date/time format might appear slightly different in the locale.
Last Modified: ddmmmyyyy:hh:mm:ss
Filename
File size (bytes)
RECFM
LRECL

Information-item for pipe files can be one of these file information items:

Unnamed pipe access device
PROCESS
RECFM
LRECL

UNIX Specifics: Information-item for disk files can have one of the following values:

Filename
Owner Name
Group Name
Access Permission
Last Modified
File Size (bytes)

If you concatenate filenames, then an additional information-item, File List, is available.

If you are using pipe files, then the only valid value for information-item is PIPE Command.

Comparisons

The FOPTNAME function determines the names of the available file information items.
The FOPTNUM function determines the number of system-dependent information items that are available.

Example

This example stores information items about an external file in a SAS data set:

data info;
   length infoname infoval $60;
   drop rc fid infonum i close;
   rc=filename('abc', 'physical-filename');
   fid=fopen('abc');
   infonum=foptnum(fid);
   do i=1 to infonum;
      infoname=foptname(fid, i);
      infoval=finfo(fid, infoname);
      output;
   end;
   close=fclose(fid);
run;

FINFO Function

Syntax

Required Arguments

file-id

information-item

Comparisons

Example

See Also