FSLIST Procedure

PROC FSLIST Statement

Enables you to browse external files that are not SAS data sets within a SAS session.

Syntax

Summary of Optional Arguments

controls how search strings for the FIND command are treated.
indicates whether carriage-control characters are used to format the display.
indicates the default horizontal scroll amount for the LEFT and RIGHT commands.
suppresses the sides and bottom of the FSLIST window's border.
controls the display of line sequence numbers.
indicates whether the carriage-control code for overprinting is in effect.

Required Arguments

FILEREF | DDNAME | DD=file-specification
specifies the external file to browse. file-specification can be one of the following:
'external-file'
is the complete operating environment file specification (called the fully qualified pathname under some operating environments) for the external file. You must enclose the name in quotation marks.
fileref
is a fileref that has been previously assigned to the external file. You can use the FILENAME statement to associate a fileref with an actual filename. For information about the FILENAME statement, see the section on statements in SAS Statements: Reference.
UNIT=nn
defines the FORTRAN-style logical unit number of the external file to browse. This option is useful when the file to browse has a fileref of the form FTnnF001, where nn is the logical unit number that is specified in the UNIT= argument. For example, you can specify the following: proc fslist unit=20; instead of proc fslist fileref=ft20f001;

Optional Arguments

CAPS | NOCAPS
controls how search strings for the FIND command are treated:
CAPS
converts search strings into uppercase unless they are enclosed in quotation marks. For example, with this option in effect, the command find nclocates occurrences of NC, but not nc. To locate lowercase characters, enclose the search string in quotation marks: find 'nc'
NOCAPS
does not perform a translation; the FIND command locates only those text strings that exactly match the search string.
The default is NOCAPS. You can use the CAPS command in the FSLIST window to change the behavior of the procedure while you are browsing a file.
CC | FORTCC | NOCC
indicates whether carriage-control characters are used to format the display. You can specify one of the following values for this option:
CC
uses the native carriage-control characters of the operating environment.
FORTCC
uses FORTRAN-style carriage control. The first column of each line in the external file is not displayed; the character in this column is interpreted as a carriage-control code. The FSLIST procedure recognizes the following carriage-control characters:
+
skip zero lines and print (overprint)
blank
skip one line and print (single space)
0
skip two lines and print (double space)
-
skip three lines and print (triple space)
1
go to new page and print.
NOCC
treats carriage-control characters as regular text.
If the FSLIST procedure can determine from the file's attributes that the file contains carriage-control information, then that carriage-control information is used to format the displayed text (the CC option is the default). Otherwise, the entire contents of the file are treated as text (the NOCC option the default).
Note: Under some operating environments, FORTRAN-style carriage control is the native carriage control. For these environments, the FORTCC and CC options produce the same behavior.
If the FSLIST procedure can determine from the file's attributes that the file contains carriage-control information, then that carriage-control information is used to format the displayed text. In this case the CC option is the default. Otherwise, the entire contents of the file are treated as text. In this case the NOCC option is the default.
HSCROLL=n | HALF | PAGE
indicates the default horizontal scroll amount for the LEFT and RIGHT commands. The following values are valid:
n
sets the default scroll amount to n columns.
HALF
sets the default scroll amount to half the window width.
PAGE
sets the default scroll amount to the full window width.
The default is HSCROLL=HALF. You can use the HSCROLL command in the FSLIST window to change the default scroll amount.
NOBORDER
suppresses the sides and bottom of the FSLIST window's border. When this option is used, text can appear in the columns and row that are normally occupied by the border.
NUM | NONUM
controls the display of line sequence numbers in files that have a record length of 80 and contain sequence numbers in columns 73 through 80. NUM displays the line sequence numbers; NONUM suppresses them. The default is NONUM.
OVP | NOOVP
indicates whether the carriage-control code for overprinting is in effect:
OVP
causes the procedure to honor the overprint code and print the current line over the previous line when the code is encountered.
NOOVP
causes the procedure to ignore the overprint code and print each line from the file on a separate line of the display.