The OPTIONS Procedure

PROC OPTIONS Statement

PROC OPTIONS <option(s)>;

Task		Option
Choose the format of the listing
	Specify the long form	LONG
	Specify the short form	SHORT
	Display the option's description, type and group Display the option's value and scope	DEFINE VALUE
	Display system option character values as hexadecimal values	HEXVALUE
	When displaying a path, replace an environment variable with its value	EXPAND
	When displaying a path, display the environment variable(s) the option was defined with	NOEXPAND
	Display numeric system option values using commas	LOGNUMBERFORMAT
	Displays numeric system option values without using commas	NOLOGNUMBERFORMAT
Restrict the number of options displayed
	Display options belonging to one or more groups	GROUP=
	Display host options only	HOST
	Display portable options only	NOHOST \| PORT
	Display a single option	OPTION=
	Display restricted options only	RESTRICT
Display groups and group descriptions		LISTGROUPS

Options

DEFINE

displays the short description of the option, the option group, and the option type. It displays information about when the option can be set, whether an option can be restricted, and whether the PROC OPTSAVE will save the option.

Interaction:	This option is ignored when SHORT is specified.
Featured in:	Displaying the Setting of a Single Option

EXPAND | NOEXPAND

specifies whether to replace an environment variable in a path with the value of the environment variable.

EXPAND: displays the path using the value of the environment variable.
NOEXPAND: displays the path using the environment variable.

Restriction:	Variable expansion is valid only in the Windows and UNIX operating environments.
Tip:	By default, some option values are displayed with expanded variables. Other options require the EXPAND option on the PROC OPTIONS statement. Use the DEFINE option on the PROC OPTIONS statement to determine whether an option value expands variables by default or if the EXPAND option is required.
Featured in:	Displaying Expanded Path Environment Variables

GROUP=group-name GROUP=(group-name-1 ... group-name-n)

displays the options in one or more groups specified by group-name.

Interaction:	This option is ignored when OPTION= is specified.
Requirement:	When you specify more than one group, enclose the group names in parenthesis and separate the group names by a space.
See also:	Displaying Information About System Option Groups

HEXVALUE

displays system option character values as hexadecimal values.

HOST | NOHOST

specifies whether to display only host options or only portable options.

HOST: display only host options.
NOHOST: display only portable options.

Alias:

PORTABLE or PORT is an alias for NOHOST.

LISTGROUPS

lists the system option groups for all operating environments and a description of each group.

LONG | SHORT

specifies the format for displaying the settings of the SAS system options. LONG lists each option on a separate line with a description; SHORT produces a compressed listing without the descriptions.

Default:	LONG
Featured in:	Producing the Short Form of the Options Listing

LOGNUMBERFORMAT | NOLOGNUMBERFORMAT

specifies whether to display numeric system option values using commas.

LOGNUMBERFORMAT: displays numeric system option values using commas.
NOLOGNUMBERFORMAT: displays numeric system option values without using commas.

Featured in:

Displaying the Setting of a Single Option

NOEXPAND

See EXPAND | NOEXPAND

NOHOST | PORT

See HOST | NOHOST.

OPTION=option-name

displays a short description and the value (if any) of the option specified by option-name. DEFINE and VALUE provide additional information about the option.

option-name: specifies the option to use as input to the procedure.

Requirement:	If a SAS system option uses an equal sign, such as PAGESIZE=, do not include the equal sign when specifying the option to OPTION=.
Featured in:	Displaying the Setting of a Single Option

NOLOGNUMBERFORMAT

See LOGNUMBERFORMAT | NOLOGNUMBERFORMAT

RESTRICT

displays the system options that have been set by your site administrator in a restricted options configuration file. These options cannot be changed by the user. For each option that is restricted, the RESTRICT option displays the option's value, scope, and how it was set.

If your site administrator has not restricted any options, then the following message appears in the SAS log:

Your Site Administrator has not restricted any SAS options.

SHORT

See LONG | SHORT.

VALUE

displays the option value and scope, as well as how the value was set.

Interaction:	This option has no effect when SHORT is specified.
Featured in:	Displaying the Setting of a Single Option

Note: SAS options that are passwords, such as EMAILPW and METAPASS, return the value xxxxxxxx and not the actual password. [cautionend]

Top of Page