INCLUDE

INCLUDE

Copies the contents of an external file into the current window

OS/390 specifics: file specification

Syntax
Details
See Also

Syntax

INCLUDE fileref

INCLUDE fileref(member)

INCLUDE 'physical-filename'

INCLUDE 'physical-filename(member)'

Details

This command is available in the PROGRAM EDITOR window as well as in any other window that uses the SAS Text Editor such as the NOTEPAD window. You can also include an external file from the MEMLIST or FNAME windows using selection-field commands. You can identify the external file by specifying either a fileref or the physical file name. If you specify the physical file name, you must enclose it in quotes.

Here are examples of the INCLUDE command that illustrate the various ways you can specify physical files:

INCLUDE MYPGM: MYPGM is a fileref that was previously associated with the external file.
INCLUDE MYPGM(PGM1): PGM1 is a member of the partitioned data set that is associated with the fileref MYPGM.
INCLUDE 'USERID.TEST.PGMS': sequential data set name.
INCLUDE 'USERID.TEST.PGMS(AAA)': data set name with member specified.
INCLUDE '.TEST.MYPGM': Assuming that the FILESYSTEM= system option is set to MVS, SAS prepents this data set name with the value of the SAS system option SYSPREF=, which defaults to the your system prefix. If FILESYSTEM=HFS, SAS looks into your default UNIX System Services directory for the "hidden" file .TEST.MYPGM.
INCLUDE 'HFS:/u/userid/mypgms/mypgm1.c': name of a UNIX System Services file in the hierarchical file system, represented by a partially qualified path. SAS searches for the file in the default HFS directory for that user. If the FILESYSTEM= system option was set to HFS and if MYPGM was a standard OS/390 data set, the alternate syntax of MVS: would be required above (see FILESYSTEM=).
INCLUDE 'pgms/mypgms/mypgm1.c': This is another example of a relative path to a UNIX System Services file. Any file name containing a slash (/) is assumed to be in UNIX System Services, regardless of the value of the FILESYSTEM= system option.

See Also

%INCLUDE
Specifying Physical Files
SAS Language Reference: Dictionary

Chapter Contents
Previous
Next
Top of Page