Chapter Contents

Previous

Next
The FSVIEW Procedure

PROC FSVIEW Statement


Initiates the FSVIEW procedure.

Requirement: The FSVIEW procedure must have an input data set. By default, the procedure uses the most recently created data set as its input data set. You can use the DATA= option in the PROC FSVIEW statement to select a particular data set. If you do not specify a data set and none has previously been created in the current SAS session, the procedure terminates with an error message.
Tip: Use the FORMULA= option to identify a FORMULA entry in which to store formulas for computed variables and other custom features of the FSVIEW session.


PROC FSVIEW <DATA=data-set> | <NEW=data-set <LIKE=data-set>>
<FORMULA=SAS-catalog<.formula-entry>>
<AUTOADD>
<BROWSEONLY>
<DEBUG>
<EDIT | MODIFY>
<NOADD>
<NOBORDER>
<NODELETE>


Options

AUTOADD
turns on the autoadd feature. A new observation is displayed when the FSVIEW window is opened. Another new observation is added automatically whenever you enter values in the previous new observation and press ENTER.

The AUTOADD option is ignored if you also specify the BROWSEONLY or NOADD option with the PROC FSVIEW statement.

BROWSEONLY
BRONLY
prevents editing of data sets during the FSVIEW session. This option disables the MODIFY command so that data sets that are opened for browsing cannot be switched to editing. It also disables the EDIT command so that additional FSVIEW windows cannot be opened for editing.

DATA=data-set<(data-set-options)>
names the SAS data set to edit or browse. By default, the FSVIEW procedure displays the most recently created data set.

If you specify both the DATA= option and the NEW= option in the same PROC FSVIEW statement, the DATA= option is ignored.

You can add data set options following the data set name. The options must be enclosed in parentheses. The FIRSTOBS= and OBS= options are ignored; all other data set options are valid. Refer to SAS Language Reference: Dictionary for a list and descriptions of data set options.

DEBUG
turns on the SAS Component Language (SCL) source-level debugger. The debugger is useful for finding and correcting errors in formulas. See SAS Component Language: Reference for information on using the debugger.

EDIT
MODIFY
opens the initial FSVIEW window for editing the data set. By default, the initial FSVIEW window is opened for browsing.

This option is ignored if the BROWSEONLY option is also used. If the data set cannot be opened for editing, it is opened for browsing instead.

FORMULA=SAS-catalog<.formula-entry>
names a SAS catalog or specific FORMULA entry that contains formulas for computed variables and other FSVIEW session parameters to be associated with the data set, or in which the procedure can store formulas and parameter settings that are defined during the current FSVIEW session.

The general form of the SAS-catalog value is
<libref.>catalog-name
If the specified catalog does not already exist, it is created.

If you specify only a one-level name, it is treated as a catalog name in the default library, WORK. You must use a two-level catalog name if you want to specify a FORMULA entry name.

The general form of the formula-entry value is
entry-name<.FORMULA>
If you specify a two-level entry name with anything other than FORMULA as the second level (entry type), the specified type is ignored; FORMULA is used instead.

When an entry name is provided, the procedure attempts to load the specified entry when the initial FSVIEW window is opened. If the entry is not found, the FSVIEW session is initiated with default FSVIEW window characteristics. A FORMULA entry that has the specified name is created when you end the FSVIEW session or when you use the SAVE FORMULA command.

Note:   If any variable names that are specified in the FORMULA entry do not match those in the data set to be displayed, then the FORMULA entry is not loaded and an error message is displayed.  [cautionend]

LIKE=data-set<(data-set-options)>
names an existing SAS data set whose structure is copied when a new SAS data set is created. (This option must be used in conjunction with the NEW= option.) When the FSVIEW NEW window is opened, the variable names and attributes of the specified data set are displayed.

You can add data set options following the data set name. The options must be enclosed in parentheses. Refer to SAS Language Reference: Dictionary for a list and descriptions of data set options.

MODIFY
See the EDIT option.

NEW=data-set<(data-set-options)>
creates a new SAS data set. If a data set that has the specified name already exists, the FSVIEW procedure terminates with an error message.

When this option is used, the procedure begins by opening the FSVIEW NEW window, in which the names and attributes of the variables in the new data set are defined. Use the LIKE= option in conjunction with the NEW= option to initialize the FSVIEW NEW window with the variable names and attributes of an existing data set. After the structure of the new data set is defined, the FSVIEW window is opened so that observations can be added. For details, see Creating New SAS Data Sets.

If you specify both the NEW= option and the DATA= option in the same PROC FSVIEW statement, the DATA= option is ignored.

You can add data set options following the data set name. The options must be enclosed in parentheses. Refer to SAS Language Reference: Dictionary for a list and descriptions of data set options.

NOADD
prevents the addition of observations to any data set that is edited during the current FSVIEW session. This option disables the AUTOADD and DUP commands so that no new observations can be added.

NOBORDER
suppresses the sides and bottom of the FSVIEW window's border in a character-based display environment.

Note:   This option is ignored in graphical windowing environments.  [cautionend]

When this option is used in a supported display environment, values can appear in the columns and row that the border normally occupies.

When the NOBORDER option is used in conjunction with the FORMULA= option, the window size that is specified in the FORMULA entry is ignored. The FSVIEW window always occupies the maximum possible number of rows and columns when the NOBORDER option is specified.

NODELETE
NODEL
prevents the deletion of observations from any data set that is edited during the current FSVIEW session. This option disables the DELETE command so that observations cannot be deleted.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.