SAS Functions and CALL Routines under Windows |
Category: | External Files |
Windows specifics: | available information items |
See: | FOPTNAME Function in SAS Language Reference: Dictionary |
Syntax | |
Details | |
Example: File Attributes When Using the Pipe Device Type |
Syntax |
FOPTNAME(file-id, nval) |
specifies the identifier that was assigned when the file was opened, generally by the FOPEN function.
specifies the number of the file information item to be retrieved. The following table shows the values that nval can have for single and concatenated files under Windows operating environments.
nval | Single File | Pipe Files | Concatenated Files |
1 | Filename | Unnamed pipe access device | Filename |
2 | RECFM | PROCESS | RECFM |
3 | LRECL | RECFM | LRECL |
4 |
|
LRECL |
|
Details |
FOPTNAME returns a blank if an error occurred.
Example: File Attributes When Using the Pipe Device Type |
The following example creates a data set that contains the name and value attributes that are returned by the FOPTNAME function when you are using pipes:
data fileatt; filename mypipe pipe 'dir'; fid=fopen("mypipe","s"); /* fid should be non--zero. 0 indicates failure */ put "File id is: " fid=; numopts=foptnum(fid); put "Number of information items should be 4; " numopts=; do i=1 to numopts; optname=foptname(fid,i); put i= optname=; optval=finfo(fid,optname); put optval=; end; rc=fclose(fid); run;
The SAS LOG Displays Pipe File Information
NOTE: PROCEDURE PRINTTO used (Total process time): real time 0.03 seconds cpu time 0.01 seconds 6 data fileatt; 7 filename mypipe pipe 'dir'; 8 fid=fopen("mypipe","s"); 9 /* fid should be non-zero. 0 indicates failure */ 10 put "File id is: " fid=; 11 numopts=foptnum(fid); 12 put "Number of information items should be 4; " numopts=; 13 do i=1 to numopts; 14 optname=foptname(fid,i); 15 put i= optname=; 16 optval=finfo(fid,optname); 17 put optval=; 18 end; 19 20 rc=fclose(fid); 21 run; File id is: fid=1 Number of information items should be 4; numopts=4 i=1 optname=Unnamed Pipe Access Device optval= i=2 optname=PROCESS optval=dir i=3 optname=RECFM optval=V i=4 optname=LRECL optval=256 NOTE: The data set WORK.FILEATT has 1 observations and 6 variables. NOTE: DATA statement used (Total process time): real time 9.64 seconds cpu time 1.16 seconds 22 proc printto; run;
Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.