SAS Component Language Dictionary |
Category: | Window |
Syntax | |
Details | |
Example |
Syntax |
sysrc=WOUTPUT(action<,argument-1<, . . . ,argument-3>>); |
contains the return code for the operation:
0 | |
0 |
are additional arguments that can be specified for some of the actions, as indicated in the following list.
clears the OUTPUT window. There are no additional arguments for this action.
clears the note marked with the 'NOTE' and causes it to use its default behavior to write only the last output.
writes the current contents of the OUTPUT window to an external file. This action allows two additional arguments:
is the fileref for the external file to which the window contents are to be written. This argument is required.
optionally specifies append mode. By default, each new output replaces any current contents of the external file. Specify the value 'A' to append the output to the external file instead.
puts the pointer at the end of the current output. The NOTE action has a direct effect on the FILE, PRINT and SAVE actions. When the output is written via WOUTPUT, the pointer is reset to get the next output.
prints the current contents of the OUTPUT window. This action allows three additional arguments, all of which are optional:
is the name of a form to use to control printing. Use name.FORM or simply name to specify a form in the current catalog. Use libref.catalog.name.FORM or libref.catalog.name to specify a form in a different catalog. The default form is the one specified in the FORMNAME option.
is the fileref for a print file. If this argument is blank or if it is not specified, the output is sent to the default system printer.
specifies append mode. Use the value 'A' to append the output to the current contents of the print file. If this argument is blank or if it is not specified, then each new output replaces the previous contents of the print file.
saves the current contents of the OUTPUT window in a catalog entry of type SOURCE, LOG, or OUTPUT. This action allows three additional arguments:
is the name of the entry in which the window contents are saved. The name can be a one- or three-level name. A one-level name saves the entry in SASUSER.PROFILE.name.OUTPUT. A three-level name saves the entry in libref.catalog.name.OUTPUT. You can also use a four-level name of the form libref.catalog.entry.type, where type is SOURCE, LOG, or OUTPUT. This argument is required.
optionally specifies append mode. Specify the value 'A' to append the output to the current contents of the entry. By default, each new output replaces the previous contents of the entry.
Details |
The list of options varies depending on the action specified.
Example |
Print the OUTPUT window and append it to the file to which the fileref EXTERN has previously been assigned. Use the form specified in a previous FORMNAME option:
rc=woutput('print','','extern','a');
Copyright © 2009 by SAS Institute Inc., Cary, NC, USA. All rights reserved.