Setting Up a Single Server for Printing

10-20 Publishing Reports to the Web with Oracle Reports Services for standard output, or to stderr for output to standard error. If you try to send the output to a file and it cannot be written to, Oracle Reports uses stderr instead. We recommend sending the output to a file because it is faster and the output can be quite large. Sample output from DEBUG_SLFIND is shown below. Notice how the debug information generated helps you identify the various setup issues, such as which PPD and AFM files are being referred to and their location. You can see all of the following in this output: ■ The various environment variables, such as TK_PPD and TK_AFM, and their values. ■ The resource files, such as the PPD and AFM, and their locations, which helps you to determine if any are the missing. ■ The default location of various resource files under ORACLE_HOME. slsfindfile: checking environment variable TK_PPD8. slsfindfile: environment variable not set slsfindfile: checking environment variable ORACLE_PPD10. slsfindfile: environment variable not set slfpath: looking up path oraclehomeguicommontkadminPPD slfexist: testing oraclehomeguicommontkadminPPD slfexist: testing oraclehomeguicommontkadminPPDdefault.ppd slsfindfile:returned oraclehomeguicommontkadminPPDdefault.ppd slfindfile: type = 39 AFMslfindfile: name = Courier-Bold slsfindfile: checking environment variable TK_AFM8. slsfindfile: environment variable not set slsfindfile: checking environment variable ORACLE_AFM10. slsfindfile: checking ORACLE_HOME environment variable. slsfindfile: environment variable set to oraclehome len=18 slfpath: looking up pathoraclehomeguicommontkadminAFM slfexist: testing oraclehomeguicommontkadminAFM slfexist: testing oraclehomeguicommontkadminAFMCourier-Bold slsfindfile:returned oraclehomeguicommontkadminAFMCourier-Bold slfindfile: name = uiprint.txt slsfindfile: checking ORACLE_HOME environment variable. slfpath: looking up pathoraclehomeguicommontkadmin slfexist: testing oraclehomeguicommontkadmin slfexist: testing oraclehomeguicommontkadminuiprint.txt slsfindfile: returned oraclehomeguicommontkadminuiprint.txt

10.7.2 TK_DEBUG_POSTSCRIPT

This variable effects the PostScript output generated by Oracle Reports. Table 10–5 shows the settings for this variable. Table 10–5 Settings for TK_DEBUG_POSTSCRIPT Setting Description Functions Func Function lists each toolkit function called in comments in the PostScript output. Long L Long produces more intelligible PostScript output but runs much more slowly than normal PostScript generation. Memory Mem Memory displays memory usage at the bottom of each page. Printing on UNIX with Oracle Reports 10-21 Any of the options can appear in the environment variable, abbreviated down to one letter. You can set it to any combination of these, separated by . This variable is case insensitive. For example, FuncLMem would give you all three options.

10.8 Removing DISPLAY and Printer Dependencies on UNIX

Prior to Oracle Reports 10g Release 1 9.0.4 on UNIX, you had to set the DISPLAY environment variable in order for Reports Server to use the windowing system display surface for creating images and getting pixel resolution. This dependency is removed with Oracle Reports 10g. Additionally, earlier releases required a valid printer on UNIX for fonts. When no valid printer was available, Oracle Reports Services used the screen fonts, which again required setting the DISPLAY environment variable. Now, Oracle Reports Services includes a default screen printer surface, ScreenPrinter, that emulates a screen or printer for fonts in the absence of an available printer. As a result, Oracle Reports Services no longer requires a printer on UNIX. By default, the environment variable REPORTS_DEFAULT_DISPLAY is set to YES, which specifies that Oracle Reports Services should: ■ remove the dependency on the DISPLAY environment variable UNIX only ■ use ScreenPrinter for surface resolution for images and font information UNIX only ■ enable the Advanced Imaging Support all platforms If you wish to revert to the dependency on the DISPLAY environment variable as in releases prior to 10g Release 1 9.0.4, you can set REPORTS_DEFAULT_DISPLAY=NO.

10.8.1 ScreenPrinter

The PostScript printer driver screenprinter.ppd provides surface resolution for images and specifies font information. This driver is the first entry in uiscreenprint.txt. The file locations UNIX only are: uiscreenprint.txt : ORACLE_INSTANCEconfigFRComponentfrcommonguicommontkadmin screenprinter.ppd : ORACLE_ INSTANCEconfigFRComponentfrcommonguicommontkadminPPD ScreenPrinter is used for: ■ Surface resolution when REPORTS_DEFAULT_DISPLAY=YES. Note: The PostScript output from this variable is for your own debugging purposes. You need not provide this output to Oracle Support for investigation. See Also: Section B.1.42, REPORTS_DEFAULT_DISPLAY Note: Beginning in Oracle Reports 11g Release 1 11.1.1, configuration of screenprinter.ppd should be done only through Oracle Enterprise Manager. Refer to Chapter 7, Administering Oracle Reports Services Using Oracle Enterprise Manager , Section 7.9.1, Configuring Fonts for information about updating configuration settings through Oracle Enterprise Manager.