Previous Page | Next Page

Functions and CALL Routines

FCLOSE Function



Closes an external file, directory, or directory member.
Category: External Files
See: FCLOSE Function under z/OS

Syntax
Argument
Details
Examples
See Also

Syntax

FCLOSE(file-id)


Argument

file-id

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


Details

FCLOSE returns a 0 if the operation was successful and [ne]0 if it was not successful. If you open a file within a DATA step, it is closed automatically when the DATA step ends.

Operating Environment Information:   In some operating environments you must close the file with the FCLOSE function at the end of the DATA step. For more information, see the SAS documentation for your operating environment.  [cautionend]


Examples

This example assigns the fileref MYFILE to an external file, and attempts to open the file. If the file is opened successfully, indicated by a positive value in the variable FID, the program reads the first record, closes the file, and deassigns the fileref:

%let filrf=myfile;
%let rc=%sysfunc(filename(filrf,
   physical-filename));
%let fid=%sysfunc(fopen(&filrf));
%if &fid > 0 %then
   %do;
      %let rc=%sysfunc(fread(&fid));
      %let rc=%sysfunc(fclose(&fid));
   %end;
%else
   %do;
      %put %sysfunc(sysmsg());
%end;
%let rc=%sysfunc(filename(filrf));


See Also

Functions:

DCLOSE Function

DOPEN Function

FOPEN Function

FREAD Function

MOPEN Function

Previous Page | Next Page | Top of Page