SAS Companion for UNIX Environments

Setting Up Host Printing

If you choose to use host printing, you must first turn on host printing and set up your printer devices. You can set up a printer device to send output to a printer or to a file that is compatible with a specific Postscript or PCL printer. After you set up a printer, you can change options such as fonts, margins, orientation, and page size.

Note: Printer device definitions are stored in your SASUSER.PROFILE catalog. You cannot use profile catalogs from previous releases of SAS. If you have been running a revious release of SAS, rename the PROFILE.SCT01 file located in your SASUSER directory before you start your SAS session. [cautend]

Turning Host Printing On and Off

Host printing is not available by default, so you must turn host printing on before you will be able to access the host printing menus. Host printing can be turned on

by issuing the DLGPRTMODE HOST command.
through the Preferences dialog box. To open the Preferences dialog box, you can either issue the DLGPREF command or select

Tools Options Preferences...

Preferences Dialog Box

In the Preferences dialog box, select the DMS tab and then select Use host printing. Select [OK] to close the Preferences dialog box.

After you turn host printing on, the Print Utilities selection in the File pull-down menu is replaced with two new selections:

Print preview...: enables you to view text and graphics on the screen before you send it to a printer.
Print setup...: enables you to define host printer devices (which can be a printer or a file) and select one of these devices as your default printer device.

Host printing will remain active until you turn it off. You can turn host printing off by issuing the DLGPRTMODE GRAPH command or by deselecting Use host printing in the Preferences dialog box.

Setting Up Your Own Printer Devices

Note: If you are a system administrator and you are creating printer device definitions for use by all of the users at your site, see Setting Up Printers for All Users at Your Site. [cautend]

To set up your own printer devices, open the Printer Setup dialog box either by issuing the DLGPRTSETUP command or by selecting

File Print Setup...
(This pull-down menu selection appears only after you have turned on host printing.) This dialog box lists the printer devices that your SAS Installation Representative has defined for your site, and it lists each of the printer devices that you have defined. Printers that are defined by your Installation Representative are shown with a printer icon, and devices that you have defined are shown with an icon denoting a person.

Printer Setup Dialog Box

[IMAGE]

SAS automatically defines one printer device for you: Print PostScript to disk. This device formats output in generic Postscript using Courier font with no margins and prints the output to a file named prn.ps in the current directory. Your SAS Installation Representative might have also defined other devices for your site. Your default printer device is highlighted. To change your default printer device to another device that is already defined, simply select the new default device and select [OK].

For each new printer device that you want to define, follow these steps:

Select New.... SAS builds a list of the printer types available at your site and prompts you for the name you want to assign to the device you are creating.
Note: At any point during this set-up process, you can select <-Previous to return to the previous step.
Type the name that you want to use to identify the printer device and press Enter or select [Next->]. You can enter up to 99 characters in the name. Use a name that distinguishes this device from the others that you define such as "Apple printer with one-inch margins." SAS then prompts you to enter which type of printer device that you are defining.
Select the printer type from the list. If your specific printer type is not in the list, try one of the generic drivers, such as Generic Postscript. If the generic driver does not work, try a driver for a related printer. Often, printers made by the same manufacturer have similar specifications. Also, your printer may emulate one of the printers on the list. For example, many laser printers emulate Hewlett-Packard LaserJet printers. If you cannot determine which printer type to choose from the list, contact your SAS system administrator.
After you select a printer type, press Enter or select [Next->] to select an output destination.
To send output directly to the printer, select Printer and type the command necessary to route output to the printer that you are defining. Include the full pathname of the command.
To send output compatible with the selected printer to a file, select File and type the filename to which you want to send output.
Note: If you are using a LaserJet printer in PCL or HPGL mode, you will probably want to create two printer device definitions: one for text and one for graphics. When you are printing graphics in PCL or HPGL mode, you may need to add the -oraw option to your lp or lpr command. If the -oraw option is not available on your system, contact SAS system administrator for additional information.
PostScript printer devices can be used for printing text or graphics.
Press Enter or select Next-> to finish the process of defining the printer device.
Select Finish to return to the Printer Setup dialog box.
At this point, you can do any of the following:
Select [OK] to exit the Printer Setup dialog box. Your device definitions are saved to SASUSER.PROFILE.PRTINFO.XPRINTER.

Removing a Printer from the Selection List

To remove a printer device from the selection list, open the Printer Setup dialog box by issuing the DLGPRTSETUP command or select

File Print Setup...
In the Printer Setup dialog box, select the printer that you want to remove and then select [Remove...]. SAS asks you to confirm your request. Only your system administrator can remove printers that the administrator has defined for your site. If you select a printer that was defined by your system administrator, the [Remove...] button will be shaded.

Changing Printer Device Properties (Fonts, Margins, Other Options)

To change the properties for a printer device, issue the DLGPRTSETUP command or select

File Printer setup...
Select the printer device for which you want to change properties, and then select [Properties...]. SAS displays the Printer Properties dialog box.

Printer Properties Dialog Box

[IMAGE]

Note: The Font: field and the [Font...] and [Margins...] buttons will not appear if this dialog box is invoked from a GRAPH window. Fonts and margins set through this dialog box affect only printing from text windows. To change fonts and margins when printing from GRAPH windows, use the GOPTIONS statement. [cautend]

Name:

displays the name that you entered for the device when you set it up. You can edit the name.

Model:

displays the vendor and model for the printer you selected for this device. You cannot change this information directly. You can return to the Print Setup dialog box, remove the printer device, and create a new device definition.

Route output to

allows you to select whether the device sends output directly to the named printer or to a file compatible with the named printer. If you select File, the text field contains the name of the file. If you select Printer, the text field contains the command that is needed to route your output directly to the named printer. You can edit the filename or command as needed.

Font:

displays the current font.

Line Size: and Page Size:

display the line size and page size that SAS has calculated for the current options, margins, and font settings. You cannot set these values directly, but they will change according to the paper size, font, margins, and orientation settings that you specify.

Note: After you have finished defining all of the options for your printer device, check these line size and page size values. Make sure than the LINESIZE and PAGESIZE system options specified for your application are less than or equal to the line size and page size that SAS has calculated for the current printer options. [cautend]

[Options...]

opens the Options dialog box which allows you to change paper size, orientation, resolution, paper tray, and scale. See Setting Printer Options for more information.

[Margins...]

opens the Margins dialog box, which allows you to change the top, bottom, left, and right margins for when you print from text windows. You can enter settings directly into each field or change the settings with the up and down arrows to the right of each field. All measurements are in inches. If you enter measurements in centimeters, they will be converted to inches. For example, if you enter 2.54 cm, the Margins dialog box will display 1.00" the next time you open the dialog box. Increasing the top or bottom margins will decrease the page size value displayed in the Printer Properties dialog box, and increasing the left or right margins will decrease the line size value.

Select [OK] when you have finished.

When you print from a GRAPH window, you must use a GOPTIONS statement to set the font and margins. Font and margin settings that are entered through the UNIX dialog boxes have no effect when you print from GRAPH windows.

[Font...]

displays the Host Font dialog box, which allows you to change the font for printing from text windows. Use the GOPTIONS statement to specify the font that will be used for printing from GRAPH windows. See Changing Printer Fonts for more information.

Setting Printer Options

When you select [Options...] from the Printer Properties dialog box, SAS displays the Printer Options dialog box.

Printer Options Dialog Box

[IMAGE]

To change the paper size, resolution (in dots per inch), or paper tray, select the down arrow to the right of the field and select the value you want. The resolution is listed in dots per inch (dpi). Most printers are either 300 or 600 dpi. Higher dpi values produce sharper text and graphics. To change the orientation, select Portrait or Landscape.

The value in the Scale: field tells the printer device how large the output should be. To enlarge your document, enter a number greater than 100. To reduce your document, enter a number less than 100. For example, a scaling factor of 50% will print your document at half of its original size, and a scaling factor of 200% will print your document at twice its original size. To change the scale, either type a new number in the Scale: field or select the arrows to the right of the field. If you increase the scale value, the line size and page size values shown in the Printer Properties dialog box will decrease. If you decrease the scale value, the line size and page size values will increase.

When you have finished making changes, select [OK].