This section applies to actions in the following action sets: clustering, freqTab, gam, ica, mbc, nmf, nonlinear, pca, phreg, pls, quantreg, regression, sampling, sandwich, simSystem, spc, and varReduce.
The display parameter enables you to specify a list of tables to display or exclude. This parameter is similar to the ODS SELECT, ODS EXCLUDE, and ODS TRACE statements which are available on the SAS client. However, the display parameter can improve performance when a large number of tables can be generated (such as in BY-group processing). Because ODS statements are processed on a SAS client, all the tables are generated on the server and sent to the client, and then the requested subset are displayed. However, the display parameter is processed on your CAS server, and generates and sends only the requested subset of tables to the client.
If you use both the display parameter and ODS statements together, the display parameter takes precedence over the ODS statements. Note that the ODS EXCLUDE statement processes tables that are sent to the client after they have been filtered by the display parameter. In some cases, it might appear that the ODS EXCLUDE statement is taking precedence because it can further filter the tables. For more information about ODS, see SAS Output Delivery System: Procedures Guide.
In the CASL language, you can specify the display parameter as follows:
display=table-list subparameters
where the table-list is a list of table names, paths, partial pathnames, and regular expressions. The table names that you can specify are listed in the specific action chapters. The subparameters that you can specify are described in the Syntax section of the specific action chapters.
A path is a table name that is prefixed with dot-separated grouping information. For example, a SelectionSummary table that an action produces during a selection routine might have the path Bygroup1.Summary.SelectionSummary. A partial pathname does not include all groups; for example, SelectionSummary and Summary.SelectionSummary are partial pathnames for Bygroup1.Summary.SelectionSummary.
When you specify a table name or partial pathname, all display tables whose paths end in the specified name are selected for display or exclusion. For example, both SelectionSummary and Summary.SelectionSummary select Bygroup1.Summary.SelectionSummary.
A regular expression is enclosed in forward slashes (/). For example, specifying "/tions/" selects all pathnames that contain the substring "tions"; in particular, the Bygroup1.Summary.SelectionSummary table is selected. Specifying "!/tions/" selects all pathnames that do not contain the substring "tions"; in particular, the Bygroup1.Summary.SelectionSummary table is not selected.