FILENAME

FILENAME

Assigns or deassigns a fileref for an external file, a directory, or an output device and returns a value

CMS specifics: host options, devices, dir-ref

Syntax
See Also

Syntax

FILENAME (fileref, filename<,device <,host-options <,dir-ref>>>)

fileref

specifies the fileref to assign to an external file.

filename

specifies the external file. Specifying a blank filename deassigns one 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 that the file is to be read from or written to disk. This is the default, which does not have to be specified. This device type uses the native CMS interface.
DUMMY: specifies that output to the external file is to be discarded.
PIPE: a CMS pipeline
PRINTER: a printer or printer spool file
PUNCH: associates the fileref with the virtual PUNCH. This device is for output only. Specifying this device type causes the CMS SAS interface to issue a FILEDEF for the device. Use the CP SPOOL and TAG commands to control the destination.
READER: specifies that the file is to be a reader file. The BLKSIZE= option is ignored for this device because CMS does not support blocking. This device is for input only. Specifying this device type causes the CMS SAS interface to issue a FILEDEF for the device. If you have more than one file in your reader, the one that is ordered first is read. Use the CP ORDER READER and CP QUERY READER commands to determine the order of your reader files.
TERMINAL: the user's terminal
TAPE: a tape drive.

host-options

are host-specific options that may be specified in the FILENAME statement. See FILENAME.

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 quotes. However, if a value contains one of the supported national characters ($, #, or @), the quotes are required.

dir-ref

specifies the fileref that is assigned to the directory in which the external file resides.

See Also

SAS Language Reference: Dictionary

Chapter Contents
Previous
Next
Top of Page