ScreenPrinter Removing DISPLAY and Printer Dependencies on UNIX

10-24 Publishing Reports to the Web with Oracle Reports Services ■ Printed Output Issues

10.9.1 Common Printing Error Messages

REP-00177 - Error while running in remote server REP-1800 - Formatter error REP-3300 - Fatal error in component name UI-9 - This function call is out of context. REP-3002: Internal error initializing printer information Cause: These errors generally indicate a printer configuration issue. Action: Check the printer queues that have been defined at the operating system level in your setup. You can use: ■ lpc status ■ lpstat -a If a valid printer queue is installed, check for the following: ■ uiprint.txt must have a valid entry for the printer. ■ Oracle Reports must be able to open and read the uiprint.txt file: The person running the report must have operating system level read permissions on uiprint.txt. Oracle Reports must be able to open the uiprint.txt. UNIX operating systems do have an open file limit. If you are over that limit, Oracle Reports might not be able to open uiprint.txt. ■ The printer description files specified in uiprint.txt must exist in your installation in: ORACLE_INSTANCEconfigFRComponentfrcommonguicommontkadmin ■ The printer specified in uiprint.txt must be enabled at the operating system level. A quick test is to try printing any file from the command line using lp or lpr. If you can print using one of these commands and get the output on the printer, then the printer is enabled. Note: Reports Server uses rwlpr for submitting a print job. For rwlpr logging for Windows, when you enable tracing for Reports Server using either traceModule=all or traceModule=server, a printing diagnostic log server_ name-rwlpr-jobid.log is created in the log directory ORACLE_ INSTANCEdiagnosticslogsReportsServerComponent reports server name for destype=printer. This log file will contain information regarding the messages that can be used to diagnose any printing issues, such as spooler problem. Printing on UNIX with Oracle Reports 10-25 ■ The printer queue and uiprint.txt entry syntax must be valid. If the printer validation fails, refer to the environment variables TK_PRINT_ STATUS and REPORTS_NO_DUMMY_PRINTER in Appendix B, Environment Variables . REP-00826 - Invalid printer driver xxx specified by parameter desformat. REP-00177 - Error while running in remote server When run through CGI Cause: An invalid value was specified for DESFORMAT for the specified report execution mode. Action: The DESFORMAT parameter specifies which output format is needed. Valid formats are: ■ For bitmapped reports, any of the output formats supported by Oracle Reports PostScript, PCL, PDF, HTML, XML, HTMLCSS, ENHANCEDSPREADSHEET, SPREADSHEET is valid for DESFORMAT. You should not give the PRT file names here. While running to a file, the DESFORMAT parameter needs to be set to a valid printer queue. Oracle Reports uses the printer definition file associated with the printer to format the output. ■ For character mode reports, DESFORMAT sets up the output for ASCII printers and passes escape characters. For running character mode reports, ensure that you change the MODE parameter to Character and use any valid .PRT file. Table 10–7 maps the command line options DESTYPE, DESNAME, and DESFORMAT to the printer by what you are trying to achieve. REP-01800 - Formatter error. REP-00177 - Error while running in remote server When run through CGI Cause: The error indicates that a printer configuration issue has occurred on a UNIX server. Even if there is not a physical printer available on the system, you have to set it up as if there was one. Action: 1. Verify that there is a valid entry in uiprint.txt.

2. If you have multiple printer queue entries in uiprint.txt and you want to set

the default printer, verify that the environment variable is set to a printer that is Table 10–7 DESTYPE, DESNAME, and DESFORMAT Settings By Case Case DESTYPE DESNAME DESFORMAT Generating to a file FILE file_name.ps printer_name Printing PRINTER printer_name DISTRIBUTE=YES printer_name MODE=CHARACTER file_name.prt