Chapter Contents


SAS/FSP Software Procedures Guide

Printing Commands

opens the FONT window and displays the font control information from the current form. The listing shows what 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. For more information, see the description of the FORM window the online Help for base SAS software.

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>
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. For more information about forms, refer to the online Help for base SAS software.

When a form is required, the SAS System looks for the specified FORM entry first in the current catalog (if a catalog is currently open). If the form is not there, the system 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 return to 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>>
specifies a file to which the procedure sends documents that are created with the FSLETTER procedure or with the SPRINT command. 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.

You identify the target file by using 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 sent to an existing file to overwrite the current contents of the file. To add the new output to any existing contents instead, use the APPEND option.

Use the PRTFILE CLEAR command to cancel the previous PRTFILE command and 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>
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. If you want to send all output to a file instead of to the printer, use the PRTFILE command before issuing a SPRINT command. To route an individual capture to a file instead of to the printer, or to a file other than the one that is specified by the PRTFILE command, use the FILE= option with the SPRINT command. Changing output destinations within a procedure 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 procedure from which you captured window contents. Use the SPRINT FREE command to free the print queue or print file before ending the procedure.

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

Chapter Contents



Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.