SAS(R) 9.1.3 Companion for z/OS

260 FILENAME Function Chapter 13
filename
specifies the external file. Specifying a blank filename (‘ ’)deassigns the fileref that
was previously assigned.
device
specifies the type of device if the fileref points to an output device rather than to a
physical file:
DISK
specifies a disk.
DUMMY
specifies that output to the file is discarded.
PIPE
specifies an unnamed pipe.
PLOTTER
specifies an unbuffered graphics output device.
PRINTER
specifies a printer or printer spool file.
TERMINAL
specifies the user’s terminal.
TAPE
specifies a tape drive.
TEMP
creates a temporary file that exists only as long as the filename is assigned. The
temporary file can be accessed only through the logical name and is available only
while the logical name exists. If a physical pathname is specified, an error is
returned. Files manipulated by the TEMP device can have the same attributes
and behave identically to DISK files.
host-options
are host-specific options that may be specified in the FILENAME statement. These
options can be categorized into several groups. For details, see the following sections:
3 “FILENAME Statement” on page 369
3 “DCB Attribute Options” on page 379
3 “SYSOUT Data Set Options for the FILENAME Statement” on page 383
3 “Subsystem Options for the FILENAME Statement” on page 385
3 “Options That Specify SMS Keywords” on page 382
3 “Host-Specific Options for UNIX System Services Files” on page 104.
You can specify host options in any order following the file specification and the
optional device specification. When specifying more than one option, use a blank
space to separate each option. Values for options may be specified with or without
quotation marks. However, if a value contains one of the supported national
characters ($, #, or @), the quotation marks are required.
Details
FILENAME returns 0 if the operation was successful, and a non-zero number if it was
not successful.