SAS Companion for the OS/390 Environment

Directing Output to a Printer

You can direct SAS output to a printer with the PRINTTO procedure, the PRINT command or PMENU selection combined with the FORM subsystem, or with the PRTFILE command combined with the PRINT command or menu selection.

Using the PRINTTO Procedure

You can use the FILENAME statement or FILENAME function in conjunction with the PRINTTO procedure to route your output directly to a printer. Use the SYSOUT= option in the FILENAME statement or function to direct your output to the system printer. Then specify the fileref with the PRINT= or LOG= option in the PROC PRINTTO statement. The following example establishes a fileref and uses it in the PROC PRINTTO statement to redirect the procedure output:

filename output sysout=a;
proc printto print=output;

Usually, SYSOUT=A specifies that the destination is a printer; however, this is determined by the data center personnel at your site.

Example

Follow these steps to print a file with the PRINTTO procedure:

Identify a print destination:

filename myprint dest=dest99 sysout=a hold;

Identify the print destination to SAS:
```
proc printto log=myprint;
```
Remove the print destination:
```
proc printto log=log;
```

Using the PRINT Command and the FORM Subsystem

Use the PRINT command or menu selection to direct the contents of a window to your default printer. This is the easiest method of printing output. For example, issue the PRINT command from the command line of your OUTPUT window to send the contents of that window to your default printer.

The default printer--as well as other aspects of your output such as printer margins, printer control language, and font control information--are controlled by the FORM subsystem. The FORM subsystem consists of six frames that are described in detail in SAS Language Reference: Dictionary and in Host-Specific Windows of the FORM Subsystem. You use these frames to define a form for each printer that is available to you at your site. You can also define multiple forms for the same printer. (See Adding a Form.) Your local SAS Support Consultant can give you information about your default form and about any other forms that have been defined at your site.

Specifying a Form

To direct the contents of a window to a printer that is not your default printer, you can use the FORM= option with the PRINT command. Use this option to specify a form that has been defined for a different printer. For example, to copy output to a printer destination that is described in a form named MYOUTPUT, you would enter the following command-line command:

print form=myoutput

Modifying Your Default Form

To change the default destination printer and to customize other features of the output that the PRINT command generates, you can modify the default form that the FORM subsystem uses. To modify your default form, do the following:

Enter fsforms default from the command line to display your default form. If your SASUSER.PROFILE catalog contains a form named DEFAULT, then that form is displayed. If you do not have a form named DEFAULT, then the Printer Selection frame is displayed.
Select a printer from the Printer Selection frame. When you select a printer, SAS copies the default form for that printer into your SASUSER.PROFILE catalog.
Note: Printer information is site-specific; see your system administrator if you need help with selecting a printer.
Make other changes to the default form, if desired, by changing the information in the other frames of the FORM subsystem. Issue the NEXTSCR command to scroll to the next FORM frame, and issue the PREVSCR command to scroll to the previous frame. Two of these frames, the Print File Parameters frames, are used to specify host-specific printer information; they are described in Host-Specific Windows of the FORM Subsystem. The other frames are described in SAS Language Reference: Dictionary.
Enter the END command to save your changes.

Adding a Form

You can also add additional forms to the FORM subsystem. These forms can then be used with the PRINT command, as described in Specifying a Form, and they can be modified in the same manner as described in Modifying Your Default Form. For example, to create a form named MYOUTPUT, do the following:

Enter fsforms myoutput from the command line.
Select a printer from the Printer Selection frame.
Use the NEXTSCR and PREVSCR commands to scroll through the other frames of the FORM subsystem. Use these other frames to provide additional information that will be associated with the MYOUTPUT form.
Enter the END command to save your changes.

Examples

To print a file, use the following commands or their respective menu selections:

To create or update a SAS form, use:
```
fsform myoutput
```
To identify the SAS form, use:
```
FORMNAME myoutput
```
To print the contents of a window, use:
```
PRINT
```
To send a file to the printer, use:
```
FREE
```

Using the PRTFILE and PRINT Commands

You can also use the PRTFILE command, followed by the PRINT command, to print the contents of windows. This method enables you to override some of the defaults that are established by the FORM subsystem, such as the destination or the SYSOUT class.

PRTFILE establishes the destination, and PRINT sends the contents of the window to that destination. If you don't specify a destination with the PRTFILE command, PRINT automatically sends the window contents to your default printer. (See Using the PRINT Command and the FORM Subsystem for details about using the PRINT command alone.)

For example, to print the contents of your OUTPUT window on RMT5 instead of on your default printer, follow this procedure:

From the PROGRAM EDITOR window, submit a FILENAME statement or FILENAME function to allocate a destination file for the output. You can use the DEST= and SYSOUT= options to specify the destination and SYSOUT class, respectively. You can also direct the output to the HOLD queue by specifying the HOLD option. (See SYSOUT Data Set Options for the FILENAME Statement for information about other options that you can specify.) For example:
```
filename myrpt dest=rmt5 sysout=a hold;
```
Note: The destination printer that you specify in the FILENAME statement or FILENAME function must be the same type of printer as your default printer.
From a command line, issue the PRTFILE command, specifying the fileref from your FILENAME statement or FILENAME function. For example:
```
prtfile myrpt
```
From the command line of the window whose contents you want to print, issue the PRINT command.
If you want to print the contents of any other windows, issue the PRINT command from the command line of those windows. A requestor window warns you that the destination file already exists. Enter A in the requestor window to append the window contents to the destination file.
From the command line of the first window that you printed, issue the FREE command.
From the PROGRAM EDITOR window, submit a FILENAME statement or FILENAME function to clear (deassign) the fileref. Your output is not actually printed until you perform this step. For example:
```
filename myrpt clear;
```

Example

Follow these steps to use SAS commands to print a file with PRTFILE and PRINT:

Establish a print destination with the FILENAME statement:
```
filename myprint dest=dest99 sysout=a;
```
Identify the fileref as a print destination:
```
prtfile myprint replace
```
Print the file with the PRINT command or menu selection.

When directing output to a print device, for immediate printing use the FREE command or menu selection, and submit:

filename myprint clear;

For delayed printing, ending the SAS session or process forces printing to an output device.

SAS System Options that Relate to Printing

The following system options relate to the printing of SAS output:

SYSPRINT= is used when the PRINT command or PMENU selection is issued and the print file default has not been established with the PRTIFLE command, Set Print File menu selection, or Set Form Name menu selection.
FILEFORMS= specifies the default form used in the operating environment. The default form is used when a printer file is dynamically allocated, when FORMS= is not specified in the FILENAME statement, or when the SAS form being used does not have a FORMS= value.
FORMS= specifies the name of the default form that is used by the SAS FORM subsystem in the windowing environment.
FILESYSOUT= specifies the default SYSOUT class that will be used when a printer file is allocated dynamically, and when SYSOUT= is omitted from the FILENAME statement, or when the SAS form being used does not have a CLASS= value.
A valid sysout-class is a single character (number or letter only). Valid classes are site dependent. At some sites, data center personnel may have set up a default class that cannot be overridden.

Chapter Contents
Previous
Next
Top of Page