Language Reference: USE Statement

USE Statement

USE SAS-data-set <VAR operand> <WHERE(expression)> <NOBS name> ;

The USE statement opens a SAS data set for reading.

The arguments to the USE statement are as follows:

SAS-data-set: can be specified with a one-level name (for example, A) or a two-level name (for example, Sasuser.A). For more information about specifying SAS data sets, see the chapter on SAS data sets in SAS Language Reference: Concepts.
operand: selects a set of variables.
expression: is evaluated for being true or false.
name: is the name of a variable to contain the number of observations.

If the data set has not already been opened, the USE statement opens the data set for read access. The USE statement also makes the data set the current input data set so that subsequent statements act on it. The USE statement optionally can define selection criteria that are used to control access.

The VAR clause specifies a set of variables to use, where operand can be any of the following:

a literal that contains variable names
the name of a matrix that contains variable names
an expression in parentheses that yields variable names
one of the following keywords:

_ALL_

for all variables

_CHAR_

for all character variables

_NUM_

for all numeric variables

The following examples demonstrate each possible way you can use the VAR clause:

   var {x1 x5 x9};          /* a literal matrix of names         */
   var x;                   /* a matrix that contains the names  */
   var("x1":"x9");          /* an expression                     */
   var _all_;               /* a keyword                         */

The WHERE clause conditionally selects observations, within the range specification, according to conditions given in the clause. The general form of the WHERE clause is as follows:

WHERE (variable comparison-op operand) ;

The arguments to the WHERE clause are as follows:

variable

is a variable in the SAS data set.

comparison-op

is one of the following comparison operators:

<: less than
<=: less than or equal to
=: equal to
>: greater than
>=: greater than or equal to
=: not equal to
?: contains a given string
?: does not contain a given string
=:: begins with a given string
=*: sounds like or is spelled like a given string

operand

is a literal value, a matrix name, or an expression in parentheses.

WHERE comparison arguments can be matrices. For the following operators, the WHERE clause succeeds if all the elements in the matrix satisfy the condition:

= ? < <= > >=

For the following operators, the WHERE clause succeeds if any of the elements in the matrix satisfy the condition:

= ? =: =*

Logical expressions can be specified within the WHERE clause by using the AND (&) and OR (|) operators. The general form is

	clause & clause	(for an AND clause)
	clause \| clause	(for an OR clause)

where clause can be a comparison, a parenthesized clause, or a logical expression clause that is evaluated by using operator precedence.

Note: The expression on the left-hand side refers to values of the data set variables, and the expression on the right-hand side refers to matrix values.

The VAR and WHERE clauses are optional, and you can specify them in any order. If a data set is already open, all the options that the data set was first opened with are still in effect. To override any old options, the new USE statement must explicitly specify the new options. Examples of valid statements follow.

   use class;
   use class var{name sex age};
   use class var{name sex age} where(age>10);