Copies the entire contents of an external file into the current
window
| UNIX specifics: |
valid file-specification
|
|
INCLUDE <file-specification>
<portable-options> <host-options>
|
- file-specification
- can be any of the following:
- a single filename. SAS searches for the file in
the current directory. If you enclose the filename in quotes, SAS uses the
filename exactly as you specify it. If you do not enclose the filename in
quotes and if you do not specify a filename extension, SAS searches for file-specification.sas.
- an entire pathname. SAS does not
assume any filename
extensions, even if you do not enclose the pathname in quotes.
- a
fileref.
- portable-options
- are portable options for the INCLUDE command.
See
SAS Language Reference: Dictionary for information about these options.
- host-options
- are options specific to UNIX. They can
be any of the following:
- BLKSIZE=
BLK=
- specifies the number of bytes that are physically
read in one I/O operation. The default is 8K. The maximum is 1G-1.
- LRECL=
- specifies the logical record length. Its
meaning depends on the record format in effect (RECFM). The default is 256.
The maximum length is 1G.
- If RECFM=F, the value for the LRECL= option determines
the number of bytes to be read as one record.
- If RECFM=N, the value for the LRECL= option must
be at least 256.
- If RECFM=V, the value for the LRECL= option determines
the maximum record length. Records that are longer than the specified length
are truncated on input.
- RECFM=
- specifies the record format. Values for
the RECFM= option are
| D |
default format (same as variable). |
| F |
fixed format. That is, each record
has the same length. |
| N |
binary format. The file consists
of a stream of bytes with no record boundaries. |
| P |
print format. |
| V |
variable format. Each record ends
in a newline character. |
If you do not enter a file-specification, then SAS uses the filename from the previous FILE or
INCLUDE
command. In this case, SAS first asks you if you want to overwrite the file.
If you have not issued any FILE or INCLUDE commands, SAS displays an error
message indicating that no default file exists.
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
