AF Window Commands

Printing Commands

FONT

opens the FONT window and displays the font-control information from the current form. The listing shows which color and highlighting attributes the form interprets as signals to change printing characteristics. The FONT window is for browsing only; to change the font information you must open the FORM window and edit the FORM entry. See the description of the FORM window in Base SAS documentation for more information.

Note: The FONT window is not opened if no font information is defined in the current form. Instead, a message is displayed, indicating that the form contains no font information. [cautionend]

FORMNAME <form-name> FORMNAME CLEAR

specifies the default FORM entry, which contains instructions for printing images that are captured with the SPRINT command. The SAS System's default form is DEFAULT.FORM. You can use the FORMNAME command to specify a different default. See Base SAS documentation for more information about forms.

When a form is required, SAS first looks for the specified FORM entry in the current catalog. If the form is not there, SAS next looks in your personal PROFILE catalog (SASUSER.PROFILE, or WORK.PROFILE if the SASUSER library is not defined) and then, finally, in the SASHELP.FSP catalog.

Use the FORMNAME CLEAR command to resume using DEFAULT.FORM as the default FORM entry name.

Use the FORMNAME command with no arguments to display the current default form on the window's message line.

PRTFILE <fileref | 'actual-filename' <APPEND | REPLACE>> PRTFILE CLEAR

specifies a file to which output from the SPRINT command is sent. By default, output is sent to the printer destination that is specified in the current form. You can use the PRTFILE command to route the output to a file instead.

To identify the target file, you can use either a previously assigned fileref or the actual filename. If you specify a filename, it must be enclosed in quotes.

With the filename or fileref, you can also specify either the APPEND or REPLACE option to determine how output is handled when the file already exists. The default is REPLACE, which causes output that is sent to an existing file to overwrite the current contents of the file. To append the new output to any existing contents, use the APPEND option instead.

Use the PRTFILE CLEAR command to cancel the previous PRTFILE command and to route output to the printer again.

Use the PRTFILE command with no arguments to display the name of the current print file on the window's message line.

SPRINT <FILE=fileref | 'actual-filename'> <FORM=form-name> <NOBORDER> SPRINT FREE

captures the contents of the current window (except for the command and message lines). Unless you use the NOBORDER option, the window borders are also included in the capture.

Output characteristics are determined by an associated FORM entry. You can use a FORMNAME command before issuing a SPRINT command to change the default FORM entry for all captures. Use the FORM= option with the SPRINT command to select a form other than the default for an individual capture.

By default, output is sent to the printer destination that is specified in the associated form. Use the PRTFILE command before issuing a SPRINT command if you want to send all output to a file instead of to the printer. To route an individual capture to a file instead of to the printer, or to route an individual capture to a file other than the one specified in the PRTFILE command, use the FILE= option with the SPRINT command. Changing output destinations within an application automatically frees the previous print file or print queue.

Note: Once you have sent SPRINT output to a file, any additional output that you send to that file must use the same FORM entry. [cautionend]

The print queue or print file that the SPRINT command uses is freed when you end the application from which you captured contents. To free the print queue or print file before ending the application, use the SPRINT FREE command.

You can use the SPRINT command to capture information from several windows in a single print file or print queue. In this case, the print file or print queue is not freed until you end the application that sent output to the file or queue.

Top of Page