The ODS Statements

ODS LISTING Statement

Opens, manages, or closes the Listing destination.

Featured in: Selecting Output for the HTML and Printer Destinations

ODS LISTING <action>;

ODS LISTING <DATAPANEL=number | DATA | PAGE>;

To do this ... Use this action

Close the Listing destination CLOSE

Select output objects for the Listing destination SELECT

Exclude output objects from the Listing destination EXCLUDE

Write to the SAS log the current selection or exclusion list for the Listing destination SHOW

To do this ...	Use this action
Close the Listing destination	CLOSE
Select output objects for the Listing destination	SELECT
Exclude output objects from the Listing destination	EXCLUDE
Write to the SAS log the current selection or exclusion list for the Listing destination	SHOW

Without an Action or Options

If you use the ODS LISTING statement without an action or options, it opens the Listing destination.

Actions

An action takes some action regarding selection and exclusion lists, or closes the Listing destination. action can be one of the following:

CLOSE

closes the Listing destination. When an Output destination is closed, ODS does not send output to that destination. Closing an unneeded destination frees some system resources.

Featured in:

Selecting Output for the HTML and Printer Destinations

EXCLUDE exclusion(s) | ALL | NONE

excludes output objects from the Listing destination.

Restriction:	The Listing destination must be open for this action to take effect.
See also:	ODS EXCLUDE Statement

SELECT selection(s) | ALL | NONE

selects output objects for the Listing destination.

Restriction:	The Listing destination must be open for this action to take effect.
See also:	ODS SELECT Statement

SHOW

writes to the SAS log the current selection or exclusion list for the Listing destination. If the list is the default list (SELECT ALL), SHOW also writes the current overall selection or exclusion list.

Restriction:

The Listing destination must be open for this action to take effect.

Options

DATAPANEL=number | DATA | PAGE

suggests how to split a table that is too wide to fit on a single page into sections of columns and rows. Each section of columns and rows is a data panel. Each data panel has column headers at the top.

Note: In this context, a page is what the procedure uses as a page in creating the Listing output. The SAS system options LINESIZE= and PAGESIZE= generally determine the page size, although some procedures (PROC REPORT, for instance) can temporarily override the values that the system options specify. [cautionend]

number

writes the specified number of observations in a panel, if possible. More than one panel may occur on every page if space permits.

Range:

1 to the largest integer that the operating system supports

DATA

bases the size of the panel on the way the table is stored in memory. This value provides the fastest performance. However, if the table contains many columns, the number of rows in each panel may be small.

PAGE

tries to make panels that match the page size. If the table contains more columns than can fit on a page, the first page is filled with as many observations as possible for as many columns as will fit on a single line. The second page contains the same observations for the next group of columns, and so on until all rows and columns have been printed.

This arrangement will minimize the amount of space used for column headers because most pages will contain observations for only one set of columns.

Restriction: If the page size is greater than 200, ODS uses DATAPANEL=200.

Default:

PAGE

Chapter Contents
Previous
Next
Top of Page