Troubleshooting Oracle Applications Type: Status:

Content Type: BULLE Creation Date: TIN PUBLI Last Revision Date: SHED

TEXT/PLAIN 29-SEP-1999 05-OCT-2004

Purpose ------The intend to this note is to provide a basic troubleshooting guide for problems encountered with standard Oracle Applications Reports Release 11. Overview -------Basically Oracle Applications implements two type of reports, bitmap and character cell mode. Bitmap reports utilize a postscript file format and allow the use of logos, icons and fonts of a different sizes on the same report. Character cell reports are implemented in ASCII format and only print in standard text (no logos, icons or fonts of different sizes on the same report). All reports in Oracle Applications are character cell reports with the exception of three standard reports, which are implemented in postscript or bitmap mode reports. In Oracle Applications, Release 11, examples of some standard bitmapped reports in the Oracle Application Object Library module are Function Security Function, Function Security Menu and Function Security Navigator. Table of Contents ----------------I. Custom Reports II. Run Report From Commandline III. Regenerate and Relink the Reports Executable IV. Environment Variables V. Report Problems I. Custom Reports The first step in troubleshooting reports in Oracle Applications is to determine if the report is a custom Oracle Report or a standard Oracle Report. Make sure you have registered the custom report correctly, refer to the "Oracle8 Troubleshooting" Oracle Press Manual page 643, Note 93698.1 How to Create Custom Concurrent Requests for Oracle Applications Release 11.X and to the Oracle Application Developer's Guide Chapter 16. Make sure you have regenerated the custom report, refer to Note 1070541.6

How to generate a report (.rdf file) on a Unix System and Note 1020489.102 How to generate a report (.rdf file) on a Windows NT System. If the Oracle Report is a custom bitmap report, Oracle Support provides the following white papers on custom bitmap reports development and integration of the custom report with the Oracle Applications: Note Note Note Note 61996.1 66737.1 68408.1 73339.1 Setting up Bitmap Reports to run in Oracle Applications Sample Printer Configuration File UIPRINT.TXT Set Up Oracle Applications Bitmapped report on Windows NT Bespoke Bitmap Reports with Oracle Applications - Step by Step

Note: Custom reports created using the Oracle Reports 2.5 Developer/2000 default to bitmap mode. II. Run Report From Command line Test to see if possible to run report from the operating system command line. If you cannot run the report from the command line then the problem is with the operating system issuing a command to run a report. Use the ar25run (Unix) executable to run a character cell and the ar25runb (Unix) to run a bitmap report. Or in NT, use the r25run32 executable to run the report from the command line. The backend or database tier is where Oracle Reports 2.5 reside. A. Unix Refer to Note 98602.1 How to Print an Oracle Report for the Unix Command Line for Rel 10.7 & Rel 11 B. NT 1. In NT use the r25run32.exe executable to run a report. an example, sending a report to printer: The following is

Prompt> cd $FND_TOP\reports (i.e., cd applr11\11.0.28\reports) Prompt> r25run32 userid=apps/apps@vd11 report=FNDMNNAV.rdf destype=COLPRT21 desname=FNDMNNAV.dat batch=yes In this example vd11 is the instance and COLPRT21 is the printer name. 2. Sending a report to a file: Prompt> cd $FND_TOP\reports (i.e., cd applr11\11.0.28\reports) Prompt> r25run32 userid=apps/apps@vd11 report=FNDMNNAV.rdf destype=file desname=FNDMNNAV.dat batch=yes 3. In NT, to run a bitmap mode report, use the r25run32.exe. Ensure that the Windows printer driver you have installed supports either Postscript or PCL as required.

III.

Regenerate Reports

You may regenerate the reports using the installation utility adadmin or regenerate the reports from the commandline. A. Unix regenerate reports from command line Note 1070541.6 How to generate a report (.rdf file) from the Unix Command Line. B. NT regenerate reports from command line Note 1020489.102 How to generate a report (.rdf file) from a Windows NT Command Line. IV. Relink the Reports Executable In Unix, you can relink the reports executable, ar25run and ar25runb. 1. This command will actually make the reports executable: Logon as applmgr/<password> Prompt> cd $ORACLE_HOME/reports25/lib Prompt> make -f ins_reports25wv8.mk install 2. Use adrelink to re-create a corrupted or missing reports executable for report in Unix, for example, Logon as applmgr/<applmgr> Prompt> cd $FND_TOP/bin Prompt> adrelink force=y ranlib=y "fnd ar25run" Or Logon as applmgr/<applmgr> Prompt> cd $FND_TOP/bin Prompt> adrelink force=y ranlib=y "fnd ar25runb" Environment Variables

IV.

For Fresh installation of the Oracle Applications or upgrades verify that the Oracle Reports environment variables are configured correctly. In NT, the report environment variables are contained in the NT registry. A. Unix Report Environment Variables 1. APPLORB & APPLORC: The executable ar25runb should be assigned to the variable APPLORB (bitmap mode reports) and the executable ar25run should be assigned to the variable APPLORC (character cell or character mode reports). For example, PROMPT:/appl01/v1103> echo $APPLORB ar25runb PROMPT:/appl01/v1103> echo $APPLORC

ar25run 2. REPORTS25_PATH: Oracle uses the REPORTS25_PATH environment variable for locating external references such as PL/SQL libraries. For example, PROMPT:/appl01/v1103> echo $REPORTS25_PATH /appl01/v1103/au/11.0.28/plsql:/appl01/v1103/fnd/11.0.28/reports: 3. AU_TOP: (Applications Utilities) points to a directory that holds files shared by Oracle Applications products. 4. REPORTS25_TMP: sets the location of temporary files. If this variable is not set, the temporary files are placed on the default directory on your machine. 5. PRINTER: sets the default printer PROMPT:/appl01/v1103> echo $PRINTER COLPRT42 B. Windows NT Report Environment Variables 1. 2. From the NT Start menu, select 'Run' then enter 'regedit' as the program name and click on OK or hit ENTER. Open the 'HKEY_LOCAL_MACHINE' window, then navigate to Software --> Oracle --> Applications --> 11.0.0--><APPL_CONFIG> where <APPL_CONFIG> is the value of the APPL_CONFIG registry entry. Check the following registry entries APPLORB : r25run32 REP25_USEREXIT : D:\OA\APPLPROD\AU\11.0.28\BIN\APPR25UE.DLL; REPORTS25_TMP 4. 5. : D:\TEMP -- Example only

3. only

-- Example

Open the 'HKEY_LOCAL_MACHINE' window, then navigate to Software --> Oracle

Check the following registry entries REPORTS25_PATH : D:\OA\APPLPROD\AU\11.0.28\PLSQL;D:\OA\APPLPROD\FND\11.0.28\REPORTS; -- Example only V. Report Problems

A. Print landscape instead of portrait Problem: Oracle Applications standard reports are printing in landscape orientation instead of portrait or portrait orientation instead of landscape. Solution: Navigate to Printer Driver (FNDPRMPD) form a. Initialization string escape sequence for portrait orientation is normally,

/e&l0O (lower case L, zero and uppercase O) b. Initialization string escape sequence for landscape orientation is normally, /e&l1O (lower case L, the number one, upper case O) B. Executables ar25run or ar25runb (Unix only)are missing Problem: The ar25run and/or ar25 are not present in directory $FND_TOP/bin Solution: run the utility adrelink to re-create the executables cd $FND_TOP/bin PROMPT> adrelink force=y ranlib=y "fnd ar25run" or cd $FND_TOP/bin PROMPT> adrelink force=y ranlib=y "fnd ar25runb" C. REP-1219 Problem: While running a report you receive following error: REP-1219 <object name> has no size - length or width is zero Solution: REP-1219 is caused when you developed or create the report using Reports 2.5 Developer/2000 in bitmap mode and in Oracle Applications run the report as a character cell report. If you are using standard report, convert the *.rdf file to *.rdf with dunit=character. r25convm userid=apps/apps stype=rdffile source=test.rdf dtype=rdffile dunits=character dest=test.rdf overwrite=yes batch=yes D. Reports do not appear in the QuickPick list Problem: When running standard submission reports only certain reports appear in the QuickPick list Solution: Add the report to the Request Group for the Responsibility, by a. Login as system administrator b. Navigate to Security > Responsibility > Define c. Query in 'Responsibility Name' column 'System Administrator' d. Review the 'Request Group' and note the name, in this case the request group is 'System Administrator Reports' e. Navigate to Security > Responsibility > Request f. Query in 'Group' column 'System Administrator Reports' g. In block, 'Requests' add a new record where type is 'Program' the name of the Report you wish to add to the Request Group

h. Save record E. Banner page suppression Problem: How do I suppress the banner page while printing reports through Oracle Applications even if printer style is set to "no header page", the banner page continues to print. Solution: In Unix utilizing the standard "lp" command, add the option "-onobanner" to argument field in the printer driver by a. b. c. d. e. Logon as SYSADMIN/<password> Select System Administrator Responsibility Navigate: Install, Printer, Driver Enter in the option field: lp -onobanner Bounce concurrent managers.

References ---------Note 47841.1 Applications Reports Top Issues Note 68408.1 Set Up Oracle Applications Bitmap Report on Windows NT Note 73339.1 Bespoke Bitmap Reports With Oracle Applications - Step by Step Note 1070541.6 How to generate a report (.rdf file) from the Unix Command Line Note 1020489.102 How to generate a report (.rdf file) from a Windows NT Command Line Note 98602.1 How to Print an Oracle Report from the Unix command line for Rel 10.7 & Rel 11 Note 93698.1 How to Create a Concurrent Requests for Oracle Applications Release 11.X Note 61996.1 Setting Up Bitmap Reports to run in Oracle Applications Note 66737.1 Sample Printer Configuration File UIPRINT.TXT Oracle Applications Release 11 for Unix Installation, Chapter 5 Oracle 8 Troubleshooting, Chapter 14, pages 639-659.