Pasta User’s Guide

Release 3.0
Last Updated: February 28, 2003

Pasta Users’ Guide

Contents
CONTENTS ..............................................................................................................................2 OVERVIEW ..............................................................................................................................3 SYSTEM REQUIREMENT...........................................................................................................3 TECHNICAL OVERVIEW ...........................................................................................................3 NEW FEATURES IN 3.0.............................................................................................................4 NEW FEATURES IN 2.5.............................................................................................................6 PRINTER SETUP SIMPLIFICATION.............................................................................................9 IMPORTANT CHANGES BETWEEN PASTA 2.0 AND 2.5............................................................10 Backward Compatibility with IX Library ........................................................................10 Font Settings ....................................................................................................................10 Printer Name Settings ......................................................................................................11 INSTALLING PASTA ...............................................................................................................12 DEFINING PRINTER DRIVERS FOR PRINTING..........................................................................12 Portrait Driver .................................................................................................................13 Landscape Driver.............................................................................................................13 Landwide Driver ..............................................................................................................13 DEFINING A PRINTER TYPE ...................................................................................................13 REGISTER A PRINTER ............................................................................................................14 RESTARTING THE CONCURRENT MANAGER ..........................................................................15 PRT FILES SETUP..................................................................................................................15 Special Settings for Bidi Languages ................................................................................15 Unicode and BiDi Specific Configuration .......................................................................15 BARCODE TRUETYPE FONT SUPPORT ...................................................................................16 INTEGRATION WITH THE COMMON UNIX PRINTING SYSTEM (CUPS) ...................................17 Scenario 1: CUPS is running on the concurrent node ...................................................18 Scenario 2: Multiple CUPS running on the other machine than the concurrent node....19 USING PRINTFORMS ..............................................................................................................20 Preface .............................................................................................................................20 Function Overview...........................................................................................................21 Overview of Creating a PrintForm..................................................................................21 Create the PrintForm.......................................................................................................21 Deploy a PrintForm to Oracle Applications ...................................................................26 CONFIGURATION FILE OPTIONS ............................................................................................27 Generic Options ...............................................................................................................27 Arabic, Hebrew and Thai Options ...................................................................................30 Additional Notes for Specifying TrueType Fonts for Font Parameters...........................30 COMMAND LINE PARAMETERS .............................................................................................31 FONT FILES PROVIDED BY ORACLE.......................................................................................33 SAMPLE CONFIGURATION FILE .............................................................................................34

Pasta Users’ Guide

Overview
Oracle's business strategy demands multilingual support (or MLS) for global customers. Increasingly customers require products and solutions that support their global business models. The ability to support multiple languages centrally from a single database instance is an essential requirement for the E-Business suite. The use of Unicode greatly simplifies the global data handling that EBusiness requires. Oracle increasingly uses the Unicode Standard in product development. Unicode is the industry's encoding method of choice to support multiple languages using a single character set. UTF8, one of the most commonly used encoding methods of Unicode, has been supported by Oracle E-business Suite 11i as well as other encoding methods. This encoding method has been adopted by most of the global multilingual customers. Pasta technology provides strength in multilingual support in Oracle Ebusiness Suite in particular areas that include printing (Pasta), viewing a report on-line (Vpasta) and generating bitmap reports (IX Library.) Pasta products make a significant contribution to UTF8 support but it also works for any other character set that Oracle supports This document is specific to Pasta printing utility. Pasta printing utility, also known as simply "Pasta", is a program that provides universal solutions for printing in Oracle E-Business Suite by handling multi-lingual text outputs generated by the Concurrent Manager. Any UTF8 customer who possibly has non-English data in the database must use Pasta. English-only customer or a customer who is using other character set than UTF8 can also obtain the benefit from Pasta. This product is provided as a part of Application Object Library.

System Requirement
The Pasta product is a component of the E-Business Suite’s Application Object Library (FND). Please find the system requirement for Oracle EBusiness Suite in Oracle Applications Installation Manual. This chapter describes requirements that are specific to Pasta only. PostScript Language Support on Printer Printer must support PostScript level 2 or higher. For non-PostScript printers, however, Pasta still can be used with 3rd party utilities such as Ghostscript or Xpdf. Pasta provides an interface to integrate those 3rd party utilities. Please refer to preprocess option in Pasta configuration file options. Unicode Font Pasta supports Unicode map TrueType font only.

Technical Overview
Taking Advantage of PostScript Language Pasta enables multi-lingual handling by taking advantage of PostScript language. Pasta converts an input content from text format to PostScript format to add the multi-lingual support. During the PostScript conversion,

Pasta Users’ Guide

Pasta includes all the necessary information in addition to the language handling such as paper size, font size and so on. After converting the input, Pasta sends the content to preprocess command if it is set in the preprocess option in the Pasta configuration file before printing. The content is then sent to the printer command that is specified in the printCommand option in the configuration file. Font Embedding Pasta enables printing a text report with language data for which font is not available on the printer by using the font embedding method in PostScript. Pasta creates a set of all the necessary font glyphs from a TrueType font and embeds it in the PostScript so that all the language data can be printed correctly. In addition to the font embedding Pasta also provides an alternative configuration for font setting. If the printer has fonts that can represent all the language data in the text file, customers can use the printer fonts. Please refer to “Printer Fonts (Latin 1) Support as well as TrueType Fonts” section in chapter of “New Features in 2.5.” Pass-Through Mode Pasta also supports “pass-through mode”. Pass-through means that Pasta just bypasses the conversion mechanism and sends input to the preprocess command and then to the printer as it is. This feature is useful because Pasta can handle many formats in addition to text input. By this feature, only one command can handle many input formats. For example, if there are two reports and one of them needs to be processed by Pasta but the other must go directly to the printer, there is no need to create two printer flows. There are some formats that Pasta chooses this pass-through mode automatically because of the nature of the formats. PostScript and PDF are such formats. In PostScript and PDF, all the formatting must have been done so Pasta will not do anything but sends the file to preprocess command and then to the print command. Preprocess Command To support printers that are not compatible with PostScript, Pasta provides a way to integrate with 3rd party tool to convert the document content into other format besides PostScript. For example, if there is a printer that only supports PCL printing language, we can use “preprocess” option in Pasta configuration file to set a command to convert PostScript to PCL such as Ghostscript. Another example would be that we could use Xpdf command for the preprocess option so that PDF file can be successfully printed if the input is PDF format and the printer does not support PDF to print. Language Handling Pasta also provides many language options that include complete options for bi-directional languages such as Arabic and Hebrew. The attributes related to the bi-directional languages can be configured in Pasta configuration file such as direction, lay outing. Please refer to chapter of “Configuration Files Options” for more details.

New Features in 3.0
This is a list of the new features implemented in 3.0:

Pasta Users’ Guide

and combines them into one PostScript file. Pasta utilizes the PostScript technology so there is also no printer specific knowledge is required as long as the printer supports the PostScript language. you need two steps. Pasta Users’ Guide . Step 1: When creating a report.Default. Because of the fact that stationery can be generated in electronic form. set the style of the Barcode data field to "bold". a graphical image such as a background image. One is for "Plain". With this new feature. Barcode TrueType Font Support Pasta now supports to utilize a barcode TrueType font. Pasta 3. the preprinted stationery is no more required. Pasta converts an input file to PostScript internally and this PrintForm function has Pasta read another PostScript file. which contains. you cannot use bold style for all the reports that will be printed using the same configuration file. you don't have to edit or modify their original report definition any more to do equivalent.0 introduced a new option in the configuration file. See “Using PrintForms” in this document for detail information. This new feature satisfies the requirements of easier customization and easier maintenance of the customized reports because the feature eliminates a need of the customizing the original report definition since this process is executed at printing time. the other is for "Bold". Currently. Please set the appropriate size to this option. The PrintForm also provides the better solution that can replace the pre-printed stationery solution. To print barcode. the size of the Barcode font is different than the plain font. Pasta supports only two fonts per report.Bold" in the configuration file. Step 2: Set a Barcode TrueType font file name to "Font. Usually.• • • • Oracle PrintForm™ Barcode TrueType font support PostScript Type42 font support PDF input support Oracle PrintForm™ Function PrintForm function provides a capability to add a background image to the output of Pasta. in most cases. "boldfontsize=<font size in points>" and a new command line option “-bs<font size in point>. You just need to create a PostScript file with background image and have Pasta read it. The function is called PrintForm function and the PostScript file with background image is called a PrintForm. Since Pasta uses this bold setting for barcode support and the font setting is done per configuration file.

5: • • • • • • • • • • • • • • Output Formats Currently. Type42 is suitable for displaying as well as printing. If you have a Postscript Level 2 (or higher) printer.Please refer to the chapter of “Barcode TrueType Font Support” for more detailed information. Pasta will convert it to a Postscript file. If the input is a text file. PDF File Support as Input Pasta 2. If the input is already a text output for non-Postscript printers PostScript files as input invocation of additional processes (“preprocessing”) to convert the output file as desired automatic selection of the appropriate configuration file per printer setting of environment variables in the configuration file language-specific needs definable in the configuration file operating system independent configuration more printing options in the configuration file paper size command line option debug option no print option output file location specifiable error log file location specifiable printer fonts (Latin 1) as well as TrueType Fonts Pasta Users’ Guide . Pasta 3. set the “outputFormat” option to "ps”.5 Pasta supports the following features in version 2. The result from the preprocess command will be sent to the print command specified in printCommand option. Pasta will use PostScript Type42 when embedding font. Pasta will automatically detect the format and pass it to a preprocess command without any modification. Type3 is suitable for printing but not for displaying. Pasta supports two output formats: Postscript and text. the characters in the PDF file will be displayed in better quality. If you use Type42 and convert a Postscript file generated by Pasta to a PDF file.0 now accepts PDF as an input file format as well. "psEmbeddedFontType=[type3|type42]". PostScript Type42 Font Support Pasta now supports PostScript Type42 font when embedding font into a Postscript file and introduces a new option in the configuration file. PostScript Type3 font is the current type of font that is used for font embedding.5 accepted only text and PostScript format as input. If you specify type42. New Features in 2. If the input file is a PDF file.

text. If you don't have a Postscript printer and want to send a text file to your printer. You can specify any environment variable. You can specify the output character set by the Oracle character set name (e. Pasta/IX will replace the environment variable with the actual value at runtime. Easily Customized Configuration Files Refer to “Easy customization” in “New Features in Printer Setup Simplification” below. If you set this option to "text" and want to send printer-specific escape sequences to your printer with text. Preprocessing the Output File Pasta can use a preprocessing command to invoke any executable that supports an input file and an output file (a filter program). you can generate output formats other than the formats Pasta currently supports. Language-Specific Sections in the Configuration File The configuration options are grouped into sections. By using the preprocess option.Postscript file. A section starts with a [ (left square bracket) and ends with a ] (right square bracket). Alternatively. errorlogfile parameter and outfile parameter in the configuration file will be translated into an environment variable on the operating system. For example.g.auto). margin options as well as font options. The [DEFAULT] section is mandatory. The language and territory sections are optional. Pasta will convert the data from the original character set to an appropriate one according to the NLS_LANGUAGE setting. Section names are case insensitive.g. you can use "auto" as the output character set (e. You can use redirection. Whether a file is text or Postscript is automatically detected on input. If you want to override the options in the [DEFAULT] section to meet the special needs of particular languages and territories.WE8ISO8859P1). text. Postscript File as Input If the input file is already a Postscript file. In that case. Environment Variables in the Configuration File Any variable that starts with a < (less-than) and ends with a > (greater-than) for font parameters. you can generate PCL or PDF output. set this option to "text”. you must specify the escape sequence settings in the "Initialization" and "Reset" fields in the printer driver. you can add multiple language and territory sections. Pasta will send it to the printer as is. by invoking Ghostscript. In case of text output. Pasta will invoke the filter program to preprocess the Pasta output before passing it to the printing command. some Pasta parameter will not take effect such as fontsize (-s). Pasta will simply send it to the printer as-is. Pasta Users’ Guide .

the configuration file to be used.log: includes the error log. New Printing Options in the Configuration File Postscript allows you to embed the number of copies to be printed directly in the Postscript file. and the command line options pasta. set this option to "n”." the setting on the printer will be used. you can eliminate the header page normally printed between reports. This option takes the form Duplex=[y|n|default] Command Line Option for Paper Size The ‘-pw’ (page width) and ‘-ph’ (page height) command line options override the “pagewidth” and “pageheight” settings in the configuration file. Pasta will translate the delimiter in the configuration file to an appropriate delimiter for the platform automatically. If desired. This option takes the form Embednumcopies=[y|n] You can specify duplexed or single-sided printing. To make use of one configuration file across platforms.” will cause Pasta to generate the following three diagnostic files under $APPLTMP: pasta. You can use either a / (slash) or a \ (backslash) as a delimiter in a file path. By embedding the number of copies. you combine {NLS_LANGUAGE} and {NLS_TERRITORY} into one section: [{NLS_LANGUAGE}_{NLS_TERRITORY}]. Each territory section is specified by [_{NLS_TERRITORY}] where {NLS_TERRITORY} is the Oracle territory name. regardless of the platform. If your printer does not accept the embedded value. You can use one configuration file for all platforms – there is no need to create a configuration file for each platform. One section name can contain multiple languages and/or territories separated by commas. Pasta will send the report multiple times up to the number of copies. Operating System Independent Configuration File Pasta configuration file is designed to be independent from operating system. use ‘-pn’ (printer name) command line option and “ntPrintCommand” (print command name for NT) options as appropriate.Each language section is specified by [{NLS_LANGUAGE}] where {NLS_LANGUAGE} is the Oracle language name.in: input file to Pasta Pasta Users’ Guide . Debug Option Setting the PASTA_DEBUG_LEVEL environment variable to “1. If you specifiy "default.

pdf If you want to specify the output file name in the command line. so Pasta errors are logged in the Concurrent Manager log file. you can configure a printer with very minimal manual step. You can use {inputfile} in the “outFile” option. Your printer need not have any fonts installed.ttf) for printing. The default error output is “stderr” (standard error). Printer Setup Simplification Pasta patch also includes pre-defined printer types and printer drivers as seed data for simplified printer setup on Oracle EBusiness Suite. Printer Fonts (Latin 1) Support as well as TrueType Fonts Pasta now supports fonts installed on the printer as well as TrueType font file. If your printer has a font installed that is suitable for the language of your report. By using these pre-defined settings. Error Log File The “errorlogfile” (error log file name) option in the configuration file and the ‘-el’ (error log file name) command line option are useful if you want to store the error log file. Oracle provides Andale fonts (ADUO*.pasta. Pasta will replace it with the actual input file name (without the path) specified by the ‘-f’ (input file name) command line option. WidthScaleRate (-w) option will not take effect when printer font is used. You can use any TrueType font that resides on your middle tier server. Pasta will subset and embed the required characters from the font in the Postscript output file and send it to your Postscript printer. No Print Option The “noPrint” (no print) option in the configuration file and the ‘-np’ (no print) command line option are useful when you need to generate an output file (such as a PDF file) but you don’t need to print it out. you can utilize the printer font. Pasta can support Latin1 characters only for this option at thismoment. Pasta Users’ Guide . For example: outFile=<APPLTMP>/{inputfile}. you can use the existing ‘-o’ (output file name) command line option.out: output file from Pasta Output File You can specify the storage location of the output file with the “outFile” (output file name) option in the configuration file. If you specify a TrueType font.

Pre-defined Printer Drivers Several PASTA printer drivers that work with the print styles PORTRAIT. where <printer> is the printer name. LANDSCAPE.cfg is used to print the report. With this printer type.cfg and make printer-specific changes in that file without changing the printer driver definition. Landscape. Backward Compatibility with IX Library IX Library 1. Given this function. users can print concurrent requests in Portrait. PASTA tries to find pasta_<printer>. but we strongly recommend you use the new ones. you may still use the old options. or the name of the font on the printer. Font Settings Pasta 2. then pasta. users can simply copy the default pasta. The printer type is already associated with certain report styles that are associated with corresponding printer drivers.cfg is specified by the “f” option in the PASTA command line. PASTA will look for a printer-specific configuration file and. some options have been changed.1. Landwide.0 and 2.cfg to pasta_<printer>.5 To accommodate the new features introduced in Pasta 2. If no configuration file for the specified printer exists. use that file rather than the default. Users can easily set up a printer by associating the printer with the printer type.0 (Oracle Developer 6i patchset 9 ) and 1. Pasta Users’ Guide . LANDWIDE and DYNAMIC have been defined as seed data in this release.cfg. you can now define additional configuration files that are specific to particular printers. For example. Easy Customization PASTA makes it easy to customize your printing configuration to meet special printing needs.5 supports printer fonts as well as TrueType fonts.0 (Oracle Developer 6i patchset 10) are not compatible with these changes in the Pasta configuration file. The new option allows you to specify either a path and font file.0. if one exists. Customers who are using either version of Oracle Developer need to use the previous set of parameters for IX Library separate from Pasta. and Dynamic styles to a PostScript printer with almost no additional setup steps. Important Changes between Pasta 2. Users can add any of those printer drivers to the existing printer type by associating them with new print styles.5. For backward compatibility.Pre-defined Printer Type The printer type “--Pasta Universal Printer” has been defined as seed data in Pasta patch. if the configuration file pasta. While most printing requirements will be met through the default configuration file.

0] Each OS requires a different configuration.ttf [Pasta 2.Default.<Style>=printer:<Printer font name> The <Face> must be “Default”.ttf Or Font.Default. The <Style> must be either “Plain” or “Bold”. the ‘-pn’ (printer name) command line option and the “ntPrintCommand” (print command name for NT) have been added to the configuration file.Default.5] The form of this option is: Font.ttf boldfontpath=<FND_TOP>/<APPLRSC>/ADUOB.<Style>=<TrueType font name> Or Font. [Pasta 2. Examples: Font.Default.Plain=printer:Couier-Bold Printer Name Settings In order to support an OS independent configuration file.cfg printCommand=lp printCommandOptions=-c printCommand=print printCommandOptions= [Pasta 2. Platform UNIX NT Command line -P-d<printername> -P/D:<printername> pasta. Platform ALL Command line -pn<printername> pasta.<Face>. The ‘-P’ command line option and the “printCommandOptions” in the configuration file will be obsoleted in a future release.<Face>.Plain=printer:Courier Font.Plain=<FND_TOP>/<APPLRSC>/ADUO.5] One configuration works for all platforms.0] fontpath=<FND_TOP>/<APPLRSC>/ADUO.[Pasta 2.cfg printCommand=lp -c -d{printername} ntPrintCommand=print /D:{printername} Pasta Users’ Guide .Bold=<FND_TOP>/<APPLRSC>/ADUOB.ttf Font.

Figure 1: Printer Drivers Definition Form Pasta Users’ Guide . Defining Printer Drivers for Printing Several chapters starting from this chapter show how to configure a printer with Pasta in Oracle Applications. In the explanation. a patch for correcting problems or providing new features might be available between releases. Please contact Oracle Corporation for the latest information for Pasta product. However. Installing Pasta Pasta is bundled in Oracle Applications release 11i. A Pasta patch is provided as a standard AD patch of Oracle Applications and it needs to be applied on the concurrent processing node. are used as an example. Note that all parameters are case-sensitive. Please refer to the Printers chapter in the Oracle Applications System Administrator’s Guide for the concept and the detail steps to setup the printer. Landscape and Landwide. If the printer simplification setup can meet your requirement. which are Portrait. you don’t need the steps described in these chapters. three drivers for the most commonly used styles.NOTE: {printername} will be replaced by the actual printer name passed through the ‘-pn’ command line option. Responsibility: System Administrator Menu Path: Install->Printer->Driver Note: Enter only the specified fields and leave other fields as default. Another printer driver may also be needed per customer’s requirement.

FILENAME Note that the arguments must be written in one line.Portrait Driver Driver Name: PASTA_PORTRAIT User Driver: Pasta Portrait Driver SRW Driver: P Driver Method: Program Spool File: Checked Standard Input: Unchecked Program Name: FNDPSTAX Arguments: -pn$PROFILES$. Defining a Printer Type Responsibility: System Administrator Menu Path: Install->Printer->Type Type = Pasta PostScript Description = PASTA printer type for PostScript printer Style -------PORTRAIT LANDSCAPE LANDWIDE Driver Name ---------------PASTA_PORTRAIT PASTA_LANDSCAPE PASTA_LANDWIDE Pasta Users’ Guide .CONC_COPIES -f$PROFILES$.PRINTER c$PROFILES$.PRINTER c$PROFILES$CONC_COPIES -1 -f$PROFILES$. Landscape Driver Driver Name: PASTA_LANDSCAPE User Driver: Pasta Landscape Driver SRW Driver: L Driver Method: Program Spool File: Checked Standard Input: Unchecked Program: FNDPSTAX Arguments: -pn$PROFILES$.FILENAME Note that the arguments must be written in one line.PRINTER c$PROFILES$CONC_COPIES -1 -f$PROFILES$. Landwide Driver Driver Name: PASTA_LANDWIDE User Driver: Pasta Landwide Driver SRW Driver: W Program Name: FNDPSTAX Arguments: -pn$PROFILES$.FILENAME Note that the arguments must be written in one line.

Responsibility: System Administrator Menu Path: Install->Printer->Register Printer:(Your operating system printer name) Example: Win32: \\printer_server\SharedPrinter Unix: hp_3rdfloor Type: PASTA PostScript Description: any Pasta Users’ Guide .Figure 4: Printer Types Definition Form Register a Printer At least one printer must be defined prior to this step.

For example. which are Hebrew and Arabic. Pasta Users’ Guide . L. you also need to add the following lines to each of the above files for Arabic language: nls nls nls nls locale "arabic" datastorageorder "logical" contextuallayout "no" contextualshaping "yes" Unicode and BiDi Specific Configuration Oracle Reports cannot correctly handle a UTF8 report that contains Bidi range characters.prt files under $FND_TOP\reports: code code code code "bold on" esc "[1m" "bold off" esc "[0m" "underline on" esc "[3m" "underline off" esc "[2m" Special Settings for Bidi Languages For Bidi languages.prt. PRT Files Setup Make sure to include the following lines in SRW driver file (prt file) such as P. Pasta provides a solution.prt or W. you need additional settings in prt file. This is important because the Concurrent Manager caches the information of the printer configurations and the changes will not be effected until it is restarted.Figure 5: Printer Register Form Restarting the Concurrent Manager You need to restart the Concurrent Manager whenever you change any of printer definitions in Oracle Applications.

This section describes how to configure Pasta for barcode reports as well as the requirements. perform the following steps for Oracle Reports. However.0 introduced a new configuration file option that allows you to set the font size for bold style fonts. You can also use the equivalent command line option. this solution may be appropriate for you. Pasta 3. Set the following environment variables: REPORTS60_PRINTER_CODE_BEFORE=&5 REPORTS60_PRINTER_CODE_AFTER=&4 These steps cause Oracle Reports to generate a “tagged” report. Pasta Users’ Guide . In the “tagged” report.If you are using Bidi range characters in UTF8. you may want to consider using bitmap. column separator tags separate the columns. if you have a large number of barcode reports with varying layouts.prt files: code "5" code "4" esc "[5m" esc "[4m" 2. “-bs<font size in point>”. If you have a small number of barcode reports in your system. set the barcode TrueType font file name to “Font. Barcode TrueType Font Support Pasta supports to display barcode data. Add the following escape sequences in . To print using the barcode font is a two-step process: Step 1: Creating a reports with the appropriate font style settings To print a data field as barcode it must be defined as the bold font style. set the style of the barcode data fields to bold (the font name does not matter. 1. NOTE: You have to install Developer Patchset 9 or later to have Oracle Reports generate these column boundary tags. recommendations for using this feature.Bold” Usually. the size of the barcode font is different than the plain font. Use the “boldfontsize=<font size in points>” option to set the appropriate size for your barcode font.) Step 2: Setting in Pasta configuration file for printing In the Pasta configuration file. For example: ESC[5m(column1)ESC[5m(column2)ESC[5m(column3)…. When creating the report..Default. The column separators are used to align tables and columns by Pasta.

1) when all the printers are connected to CUPS server which resides on E-Business Suite Pasta Users’ Guide . Barcode Font Support As previously described. In this case. Integration with the Common Unix Printing System (CUPS) Integration with CUPS in Oracle E-Business Suite is easy and proven. Configuration steps are described below in 2 scenarios. which simultaneously adjusts the height and the width according to a ratio defined in the font file. Print Style and Printer Driver Setup Because Pasta sacrifices this bold font setting to support the barcode font and because the font setting is defined per configuration file. Therefore one barcode font may not be appropriate for two reports with different layout requirements. You can also use the -h Pasta command line option to insert an extra space between the lines at runtime. It can only controls the barcode size by the font size. two barcode fonts are required on the system. and to maintain the simplicity of these reports. Reports containing barcode data must be tested thoroughly to ensure the expected results are produced. consider the followings: Report Layout Recommendations If the barcode data is to be displayed with other normal character data on the same report line (such as in a table style report). Pasta cannot control the height of the barcode font apart from the width. it is strongly recommended that you design the report with the barcode data in the right most column. which may impact the ability of a barcode reader to read the generated output. To ensure that the space between the report lines is sufficient to accommodate the barcode font. Pasta sacrifices the bold font setting to display barcode data for a report. For these reasons. considering both the width and height of the barcode data when designing the report. The height of the barcode font may not mach with the height of the regular font. choose the barcode font for your report carefully. Pasta cannot adjust the height of the barcode. In addition. you can insert a blank line between the report lines in the original definition. and in most cases the height of the barcode font is higher. you can define only one barcode font per Pasta configuration file. This will maintain the column layout in case the length of the barcode data varies by row. It is there fore strongly recommended that you define a new print style and associated printer driver for each type of barcode report. To accommodate this and other limitations of using barcode fonts. You cannot use the -w Pasta command line option with barcode reports because this option adjusts the space between the glyphs. you cannot use bold style for any reports that will be printed using same configuration file. If you have two reports that require different barcode fonts. You therefore must design the reports so that it does not rely on this option at runtime. you must define a configuration file for each.Because of the nature of character mode reports.

you need to define a new printer type with required styles and printer drivers. You can specify full path to the command if you maintain both UNIX standard lp command and CUPS lp command.concurrent node. Pasta Users’ Guide . Make sure that the lp command which is set for printCommand parameter in Pasta configuration file is a CUPS lp command.CONC_COPIES -l -Fpasta_cups. 3. Scenario 1 Configuration Steps: There will be no special configuration step required if the printer system has been replaced with CUPS on the server. Create a new pasta configuration file in $FND_TOP/resource directory for CUPS printing Example: pasta_cups. Create a set of printer drivers for each printer style with the configuration file created above.cfg Make sure that the lp command which is set for printCommand parameter in Pasta configuration file is a CUPS lp command.PRINTER -f$PROFILES$. and 2) when there are multiple CUPS distributed servers and printers are connected to each CUPS server. 1. Example: Printer Driver Name: PASTA_LANDSCAPE_CUPS Arguments: -pn$PROFILES$.cfg 2.FILENAME c$PROFILES$. Figure 1. Scenario 1: CUPS is running on the concurrent node All the printers are connected to CUPS server which resides on E-Business Suite concurrent node. If you maintain both the System V printing system and the CUPS. You can specify full path to the command if you maintain both UNIX standard lp command and CUPS lp command.

Register your printer with the printer style created above.You can refer to the existing printer driver definition created by Oracle such as PASTA_LANDSCAPE. In this scenario.cfg. Scenario 2 Configuration Steps: 1.-------------------LANDSCAPE PASTA_LANDSCAPE_CUPS PORTRAIT PASTA_PORTRAIT_CUPS LANDWIDE PASTA_LANDWIDE_CUPS 5. Create a pasta configuration file in $FND_TOP/resource directory for each server where the CUPS process is running. one printer type is required for each server where CUPS process is running with the physical printer. make change as follows: printCommand=lp -h <cupshost> -d {printername} <cupshost> is replaced with actual server name. Pasta Users’ Guide . PASTA_PORTRAIT or PASTA_LANDWIDE. Figure 2. Example: Printer Type: Pasta printer for CUPS Printer Style Printer Driver ------------. Example: pasta_cups1. pasta_cups2.cfg 2. Scenario 2: Multiple CUPS running on the other machine than the concurrent node There are multiple CUPS distributed servers and printers are connected to each CUPS server.cfg and pasta_cups3. Create a printer type for the CUPS printer Example: Pasta printer for CUPS Add required styles associated with the printer drivers to the printer type. 4. For each configuration file.

It has been very difficult to achieve this type of customization. It is true that there are some third party tools to help the customers who have this Pasta Users’ Guide . Create a printer type for each server in Oracle Applications.000 rdf files and also they had to repeat the modification every time they apply the patch or upgrade the software.cfg You can refer to the existing printer driver definition created by Oracle such as PASTA_LANDSCAPE. register printer1 with Pasta printer CUPS1 printer type. 4. Leave {printername} as it is. Example: Printer Driver Name: PASTA_LANDSCAPE_CUPS1 Arguments: -pn$PROFILES$.Make sure that the lp command is a CUPS lp command. Register your printer with the printer style. This parameter will be replaced by Pasta at runtime with actual printer name. For example a customer might need those graphical images to follow the customer's corporate identity standard. You can specify full path to the command if you maintain both System V lp command and CUPS lp command. For example. Example: Printer Type: Pasta printer for CUPS1 Printer Style Printer Driver ------------. Example: Pasta printer CUPS1.PRINTER -f$PROFILES$. Using PrintForms Preface There has been a requirement in Oracle E-Business Suite to customize the concurrent reports to add a company logo or a background image.CONC_COPIES -l -Fpasta_cups1.--------------------LANDSCAPE PASTA_LANDSCAPE_CUPS1 PORTRAIT PASTA_PORTRAIT_CUPS1 LANDWIDE PASTA_LANDWIDE_CUPS1 5. if printer1 is defined on the server CUPS1 and you have created Pasta printer CUPS1 printer type for the server. 3. Create a set of printer drivers for each printer style with the configuration file created above.FILENAME c$PROFILES$. Pasta printer CUPS2 and Pasta printer CUPS3 Add required styles associated with the printer drivers to the printer type. For example. a customer had to modify every single rdf file of Oracle Reports to add a company logo in which way they had to modify all of about 3. PASTA_PORTRAIT or PASTA_LANDWIDE.

The first phase is to create a PrintForm file that includes creating a PostScript image file by editor software and converting the PostScript file into PrintForm format by Pasta command. the pre-printed stationery is no more required. pitches. Function Overview Oracle now introduces a new feature in Pasta to combine multiple PostScript files into one file that is called PrintForm. This requires the knowledge of printer control commands that vary among printers.etc for every printer. Pasta converts an input file to PostScript internally and this PrintForm function reads another file. space between the lines.type of requirement but the solutions are not supported by Oracle and requires an additional licensing fee and to hire consultants who are specialized to the third party tools. Because of the fact that stationery can be generated in electronic form by this feature. This task is very hard because every customer has to arrange the position of the report in the paper by changing margins. The function is called PrintForm function and the PostScript file with a background image is called the PrintForm. With this new feature. which contains a background image for example. The second phase is to deploy the PrintForm to Oracle Applications as a part of the Concurrent Processing mechanism. and generate one PostScript file. Note that the way to deploy the PrintForm to Oracle Applications might be changed in the future. Pasta utilizes the PostScript technology so there is also no printer specific knowledge is required as long as the printer supports the PostScript language.. This has been causing very expensive cost to the customers. The PrintForm also provides the better solution that can replace the pre-printed stationery solution. There has been another requirement that some customers need to print a concurrent report on top of the pre-printed stationery. Create the PrintForm Choose an Editor and conversion mechanism Pasta Users’ Guide . This new feature satisfies the requirement of easier customization and easier maintenance of the customized reports because the feature eliminates a need of the customizing the original report definition since this process is executed at printing time.. the report has to be printed out every time a positional attribute is changed. to fit the report in the correct position in the paper. Overview of Creating a PrintForm There are two phases to apply PrintForm technology to Oracle Applications. the customers don't have to edit or modify their original report any more. They just need to pass a PostScript file with a background image when they call Pasta. In addition.

2. Excel. make sure pdftops command works fine. Install the software for conversion of a PostScript file to PrintForm file If you did not choose Oracle Reports as editor. Setup an environment 1. . you need to decide either pdftops command by Xpdf or Adobe's generic PostScript printer driver to convert a PostScript file created by the editor into PrintForm format depending on the supported combination and your requirement.Choose an editor that you will be creating the PrintForm image depending on the requirement or skill of the software.foolabs. PowerPoint with Adobe PDFMaker Any Windows Application Any Windows Application Any Application which generates PDF Platform UNIX. Xpdf Download and install Xpdf software from Xpdf web site for your platform.Need to buy Adobe Acrobat . MS Windows Interim PostScript Format Generation N/A N/A Xpdf pdftops Adobe Generic PostScript driver Color Driver from Oracle Note . Install the editor software that you have chosen the step above. You can use this utility either on the client side where you edit the image file or on the server side where you will run Pasta command to convert the PostScript file to PrintForm and locate the file on.html After installation. The table below lists the editor that PrintForm supports and their characteristics.Cannot save color information . Note that Oracle Reports Designer can be run on the same operating system as your Oracle Applications because Oracle Reports is bundled with Oracle Applications.Can save color information MS Windows PDF MS Windows N/A MS Windows N/A PDF Xpdf pdftops . Pasta Users’ Guide . Please contact Oracle support to obtain the file.Can save color information The color driver is provided by Oracle. This software adds an option to save a MS Office document in PDF format. you need to have Adobe Acrobat installed on your system.Requires PS printer driver on Windows . http://www.com/xpdf/download.File size will be smaller than colored file. Editor Oracle Reports MS Word.Can save color information . WS PowerPoint or MS Excel to create PrintForm and use Xpdf solution to generate PostScript file. If you would like to use Microsoft Office software such as MS Word.

com/support/downloads/product.adobe. Pasta Users’ Guide .jsp?product=pdrv&plat form=win Download Universal PostScript Windows Driver Installer and run the installer. make sure that you choose "Generic PostScript Printer" in the select printer model window. As the installation proceeding.com Adobe Generic PostScript Printer Driver (Windows) Go to Adobe's printer driver installation web page http://www.adobe. Create a image file by an editor Create a file by the editor you have chosen to have a company logo or preprinted stationery. Here is a sample screen shot of MS Word to add an Oracle company logo on upper right corner of the report.http://www.

a paper size of the document and the size of the margins are very important aspects to fit a PrintForm to a report. Pasta Users’ Guide . Navigate to this window through the file menu -> page settings.Please note that a style. Please make sure that those attributes are set to the intended values for your requirement. The following screen shots are the examples from MS Word in letter size paper and in landscape orientation with no margins on the right. left and bottom but a small margin on top.

you should have an icon in the tool bar area of MS Windows. Convert an original file to PostScript format The file created in the step above needs to convert into PostScript format either by pdftops command. 2. Here are the examples of both method executed with MS Word sample. Xpdf 1. Save the file in PDF format by PDFMaker If you have Adobe Acrobat Reader installed on your system. Convert the PDF file into PostScript format Pasta Users’ Guide . Push this icon and save the document in PDF format. by Xpdf or by Adobe Generic PostScript printer driver depending on the requirement.Tips: Even if you need only one type of PrintForm such as adding a company logo to all the report. you need to create one PrintForm per printer style such as Portrait. Landscape or Landwide because PrintForm depends on the style of the report.

In the Print window. Go to File -> Print menu in your application 2. Use Adobes' Generic PostScript Printer to save the file in PostScript format.Run pdftops command by Xpdf to convert the PDF file to PostScript file.ps Adobe Generic PostScript Printer Driver 1. You need to copy the file and run the command in the command line on the computer where the Oracle Applications instance is running if the machine is different than the one you generated the PostScript file. Deploy a PrintForm to Oracle Applications Place PrintForm files in APPL_TOP You can place the PrintForm file anywhere under APPL_TOP in the Concurrent node but Oracle recommends to put the file under FND_TOP/resource/<lang> directory where <lang> is replaced by a language code such as US for English or KO for Korean for maintenance convenience.ps oracle_ls. Hitting the OK button will lead you to save the file. Pasta Users’ Guide . Convert the PostScript file to PrintForm format Run the Pasta command in the command line to convert the PostScript file generated in the previous step. For example: $ pdftops oracle_ls. 3.pdf oracle_ls. For example: $ FNDPSTAX -pform oracle_ls.pf Note that this program is only available on the computer that Oracle Applications is installed. make sure printer name is "Generic PostScript Printer" and the check box for Print to file option is checked.

pf in $FND_TOP/resource/US directory and want to apply the PrintForm to PASTA_LANDSCAPE driver.auto). For example. The file is a simple ASCII text file.PRINTER -f$PROFILES$. you can specify the output character set by the Oracle character set name (for example.FILENAME c$PROFILES$. the Values.Modify the printer driver definitions in the Printer Driver form Go to Printer Driver form in System Administrator responsibility in Oracle Applications. Pasta uses the appropriate character set according to the NLS_LANGUAGE value in the FND_LANGUAGES table. They are divided into generic options and options for Arabic. and the Equivalent Command Option (if applicable) are listed for each option. the arguments field needs to be changed as follows: -pn$PROFILES$. The options are listed in the following two tables. text. The Key Name.CONC_COPIES -l -pf <FND_TOP>/resource/US/oracle_ls.auto Two output formats are supported: Postscript ("ps") and text ("text"). Note: For options that also have command line equivalents. and Thai. Modify Arguments field to add an option for PrintForm (pf<print form>) for appropriate printer driver.<charset> text. Configuration File Options The configuration file "pasta. If you use "auto" as the output character set (text. Generic Options An asterisk (*) in the values column indicates the default value. Hebrew.pf <FND_TOP> needs to be replaced with the actual path for your $FND_TOP. When the output format is text.WE8ISO8859P1). if you place a PrintForm logo_ls. the Description. Oracle recommends that you set the value in the configuration file. Key Name Value(s) Description Command Line Equivalent -x outputFormat ps (*) text. Pasta Users’ Guide . Restart Concurrent Manager Restart the Concurrent Manager to reflect the changes in the printer driver definitions.cfg" governs many printing options.

Enter a preprocessing command to invoke any executable that supports an input file and an output file (filter program).64 (*) 0. -o noPrint duplex -np N/A embednumcopies N/A copysort y (*) n 1. lp) Print command name (e. Values are “y”. “n”.25 (*) Adjusts the page height in inches. use this option to define the output file name and its destination on the middle tier. Set this option to “y” to embed the number of copies to be printed in a Postscript file. -ph N/A Pasta Users’ Guide .g.TextAutoCharset Charset The default value is taken from the FND_LANGUAGES table. Use this option to convert the output file. Using this option will eliminate the header page normally printed between reports. WidthScaleRate (-w) option will not take effect when printer font is used.g. You can override the default character value when the outputFormat is set to “text. Adjusts the page width in inches.auto”. Set this option to “y” if you do not want Pasta to produce printed output.0 (*) N/A heightScaleRate widthScaleRate -h -w pagewidth 8. print) Output file name Y n (*) default (*) y n Y n (*) N/A ntPrintCommand This is the print command for the Windows platform. N/A preprocess Executable name N/A printCommand Print command name (e. Adjusts the space between characters. Pasta will invoke the filter program before passing the file to the printing command. Adjusts the space between lines. Specify single or double-sided printing with this option. or “default” (uses the printer-side setting). You can choose to have the copies collated by setting this option to “y”. Adjusts the top margin in inches.27 (*) -pw pageheight topMargin 11. N/A outFile If you want to save the output file. This is the print command for the Unix platform.0 (*) 1.

Specifies the TrueType font file name or printer font name. The <Style> must be either “Plain”. Adjusts the right margin in inches.8 (* for landscape) 10.25 (*) 0. -bs psEmbeddedFontType N/A tabsize N/A errorlogfile (standard error output) (*) Error output file name NLS_LANG -el encoding You can override the NLS_LANG environment variable passed to Pasta by using this option. Pasta replaces a tab with the number of spaces specified in this option. “Bold”. Pasta will not function correctly. Note: This option remains for backward compatibility but will be obsolete in future releases.25 (*) 0. N/A lines Number N/A Pasta Users’ Guide . N/A N/A N/A N/A fontsize 7.<Style> 0. Set this option to have Pasta create a log file. However.<Face>. This option mostly used when Font. or “BoldItalic”.25 (*) Font name Adjusts the bottom margin in inches. Do not use this option. Font size in points. Adjust the left margin in inches. “Italic”. If Pasta changes the value. The maximum number of lines per page is controlled by SRW driver files.bottomMargin rightMargin leftMargin Font. The <Face> must be either “Default” or the actual font face name (such as Helvetica). A type of the font that will be embedded in PostScript.Bold is used for specifying a barcode font.0 (* for portrait) Size in points A value from fontsize parameter (*) type3 (*) type42 8 (*) -s boldfontsize Font size for bold font in points. the font size is calculated automatically.Defatul. If this is not set. this is usually not necessary. If you override the value incorrectly. the format of a report file will break.

If no shaping is required. Japanese. Korean) Ideographs. Note: This option remains for backward compatibility but will be obsolete in future releases. the European characters must be Pasta Users’ Guide . To lay out the text.printCommandOptions Print command options You can specify printer options with this setting. If this option is set to “y”.Defalt” option contains CJK (Chinese. You can specify the printer options using printCommand and ntPrintCommand instead. Required for Arabic data only. set this option to “y”. set this option to “y”. set it to “n”. This option is for Arabic only. Hebrew and Thai Options An asterisk (*) in the values column indicates the default value. set it to “n”. “rtl” (right-to-left). If no layout is required. Pasta will align your report by adding spaces at the end of any string that includes combined characters. Setting the value to “oracle” will use Oracle’s algorithm. some characters are combined into one glyph. Possible values are “arabic” for Arabic numerals. Pasta follows the Unicode BiDi algorithm. or “context” to use Arabic or Hindi depending on the context. and “default” (depends on the NLS_LANGUAGE setting). Options are “ltr” (left-to-right). “hindi” for Hindi numerals. If you set this option to “unicode”. bidi_algorithm oracle (*) unicode N/A direction default (*) ltr rtl y (*) n y (*) n N/A dolayout N/A doshaping N/A numerals context (*) arabic hindi N/A Additional Notes for Specifying TrueType Fonts for Font Parameters. Key Name Values Description Command Line Equivalent N/A thai_space_compensation y n (*) In the Thai language. To shape the text. CJK Ideographs If the TrueType font you specified for the “Font. N/A Arabic.

Adjusts the space between lines.Default. The default value is 1. the space between lines will be larger. The path is the absolute path to the error log file. “MS Gothic” will be used. you can use the options below.0. all characters must have the same width.) <filename> specifies the output file name.Default. you can specify a index number for each font face.plain=c:\fonts\msgothic. TrueType Collections If you want to use TrueType collection (. <filename> specifies the input file name. Adjusts the space between characters.plain=c:\fonts\msgothic.0. If <rate> is larger than 1. Example1) Font. If the font does not contain CJK Ideographs. If <rate> is larger than 1. (The default is portrait. -f<filename> -F<cfgfile> -h<rate> -w<rate> -l -o<filename> -s<size> Pasta Users’ Guide .half the width of the CJK characters to align the output.ttc) files. Overrides the fontsize option in pasta.ttc(0) In this case. FNDPSTAX [options] -c<number> -el<logfile> <number> specifies the number of copies to print. Example2) Font. Print in landscape mode.0. Example: -fmyfile. The default value is 1. Please contact with the font provider of your font if you need to know an index number of a font face in your ttc file.ttc(1) In this case. “MS P Gothic” will be used. Command Line Parameters When using the Pasta utility from the command line.txt Specifies the configuration file’s path and name. Note: This option does not work when using printer fonts. the space between characters will be larger. Specifies the error log file’s path and name.cfg.0. starting with 0.

text.auto). Converts a PostScript file <ps file> to a PrintForm file <pf file>.-bs<size> Overrides the font size in -s and fontsize for bold font The no print option prevents the report from being sent to the printer. <width> specifies the paper width in inches. <banner title> is passed to the lp command with the -t lp command option. If you use”auto” as the output character set (text. Here are the default character set values taken from the FND_LANGUAGES table. Banner option for use with the Unix lp command. NLS_LANGUAGE Character set ---------------------------------------ARABIC AR8ISO8859P6 BULGARIAN CL8ISO8859P5 CATALAN WE8ISO8859P1 CZECH EE8ISO8859P2 GERMAN WE8ISO8859P1 DANISH WE8ISO8859P1 SPANISH WE8ISO8859P1 EGYPTIAN AR8ISO8859P6 GREEK EL8ISO8859P7 LATIN AMERICAN SPANISH WE8ISO8859P1 FRENCH WE8ISO8859P1 CANADIAN FRENCH WE8ISO8859P1 ENGLISH WE8ISO8859P1 CROATIAN EE8ISO8859P2 HUNGARIAN EE8ISO8859P2 ITALIAN WE8ISO8859P1 ICELANDIC WE8ISO8859P1 -np -ph<height> -pw<width> -pform <ps file> <pf file> -pf<pf file> -pn<printername> -t<banner title> -v -x<ps| text[. <pf file> specifies a PrintForm file to be merged in a Pasta output at runtime. Two output formats are supported: Postscript (“ps”) and text (“text”). you can specify the output character set by the Oracle character set name (for example. <printername> specifies the printer name. Specifies the output format.WE8ISO8859P1). Displays the Pasta version number.charset|Auto]> Pasta Users’ Guide . <height> specifies the paper height in inches. When the output format is text. Pasta uses the appropriate character set according to the NLS_LANGUAGE value in the FND_LANGUAGES table.

Use the new ‘-pn’ option instead.txt -s10 Font Files Provided by Oracle This is a list of ten files that are bundled with Pasta patch.txt –omyfile. Note: This option remains for backward compatibility but will be obsolete in future releases.txt > FNDPSTAX -fmyfile.cfg. the format of the report file will break.ps -np 3) To print a report with font size 10 > FNDPSTAX -fmyfile. -P<printer options> Examples: 1) To check the version number > FNDPSTAX -v 2) To generate myfile.HEBREW JAPANESE KOREAN LITHUANIAN NORWEGIAN DUTCH POLISH PORTUGUESE BRAZILIAN PORTUGUESE ROMANIAN RUSSIAN SWEDISH FINNISH SLOVAK SLOVENIAN THAI TURKISH AMERICAN SIMPLIFIED CHINESE TRADITIONAL CHINESE Other than above IW8ISO8859P8 JA16EUC KO16KSC5601 NEE8ISO8859P4 WE8ISO8859P1 WE8ISO8859P1 EE8ISO8859P2 WE8ISO8859P1 WE8ISO8859P1 EE8ISO8859P2 CL8ISO8859P5 WE8ISO8859P1 WE8ISO8859P1 EE8ISO8859P2 EE8ISO8859P2 TH8TISASCII WE8ISO8859P9 US7ASCII ZHS16CGB231280 ZHT16BIG5 WE8ISO8859P1 You can override these default values by using the textAutoCharset option in pasta. If Pasta changes the value.ps from myfile. Pasta Users’ Guide . Do not use this option. The maximum number of columns is controlled by SRW driver files. <printer options> specifies the printer name and options. Note: This option remains for backward compatibility but will be obsolete in future releases. -C<number> <number> specifies the maximum number of columns.

ttf ADUOB. %%%% ========== Default settings ========================== %%%% %% The options in this default section can be overridden by the options %% in the language and territory sections below. read the % notes at the end of this file first.ttf These fonts are installed under $FND_TOP/$APPLRSC.ttf ADUOK.ttf ADUOJ.ttf ADUOTCB.ttf ADUOJB.Font name ADUO. Pasta will send it to a printer as Pasta Users’ Guide . Sample Configuration File This is a sample of pasta configuration file for multi-lingual environment. If you have a Postscript Level 2 (or higher) printer.ttf ADUOSC. % Pasta will convert it to a Postscript file.ttf ADUOTC. Please refer to the bug 2671556 for varieties of the configuration.ttf ADUOKB. % please set this option to "ps". Pasta supports two output formats: Postscript and % text.cfg -.ttf Description "single-byte" characters only (PLAIN) "single-byte" characters only (BOLD) Unicode font with Japanese Han Ideographs (PLAIN) Unicode font with Japanese Han Ideographs (BOLD) Unicode font with Korean Han Ideographs (PLAIN) Unicode font with Korean Han Ideographs (BOLD) Unicode font with Simplified Chinese Han Ideographs (PLAIN) Unicode font with Simplified Chinese Han Ideographs (BOLD) Unicode font with Traditional Chinese Han Ideographs (PLAIN) Unicode font with Traditional Chinese Han Ideographs (BOLD) ADUOSCB. % % If this is the first time you have modified this file.<charset|auto>] % % Currently. %% %% pasta.Pasta configuration file %% % This is the main Pasta/IX configuration file. If the input is % already a Postscript file. If the input is a text file. [DEFAULT] %% ========== Output Format ========================== %% % Output Format [ps|text.

ps2pdf can convert a Postscript % file to a PDF file. % You can specify the output character set by the Oracle % character set name (e. In this example. text. In most cases. {outfile} is the output file generated % by the preprocessing command. You can use % "auto" as the output character set (e. % You can use redirection.html . Pasta will convert the data from the original character % set to an appropriate one according to the NLS_LANGUAGE setting.WE8ISO8859P1). % % You can get a list of output devices available in Ghostscript % at: % http://www. Whether a file is Text or PS is automatically sensed on % input.gnu. % You can use {infile} and {outfile} in this option. Other options are ignored. % If you want to keep it. Pasta names it temporarily and % it will be deleted after being passed to the printing command.ghostscript. % % In the case of text output. "gs" is % Ghostscript and "pxlmono" is a device used with HP black and % white PCL XL printers (LaserJet 5 and 6 family). In that % case. % Ghostscript is a tool that can convert a Postscript file to % a PCL file. For % example. only the thai_space_compensation % and preprocess options are effective. % {infile} is the output file generated by Pasta. you can generate output % formats other than the formats Pasta currently supports.% is. Pasta will copy {outfile} to the file you % specify. % You can get the latest version of Ghostscript at: % www. It is a temporary % file and will be deleted after being passed to the % preprocessing command. you can name it by using the '-o' % command line option. % Preprocess for PCL printing % This is an example for PCL printing. % % If you don't have a Postscript printer and want to send a % text file to your printer. preprocess=gs -q -dNOPAUSE -dBATCH -sDEVICE=pxlmono -sOutputFile={outfile} {infile} % Preprocess for PDF output % This is an example for PDF output. By using the preprocess option.com.auto). you % must keep the escape sequence settings in "Initialization" % and "Reset" in the printer driver. Set the noPrint option to "y" or use % the '-np' (no print) command line option if you do not want Pasta Users’ Guide .g. you can generate PCL output. please set this option to "text".org/software/ghostscript/devices. % % If you set this option to "text" and want to send printer% specific escape sequences to your printer with text. outputFormat=ps %% ========== Preprocessing Command ================== %% % Pasta can use a preprocessing command to invoke any executable % that supports an input file and an output file (a filter program). Pasta will invoke the filter program % to preprocess the Pasta output before passing it to the printing % command. ps2pdf is a shell script % bundled with Ghostscript. text. you cannot send a PDF % file to the printer command because the printer command % cannot understand PDF.g. You can use % it as input for the preprocessing command.

5 . Also.ttf) % for printing. outFile=<APPLTMP>/{inputfile}. please override this value in the language and/or % territory sections. .% to have Pasta send the PDF file to a printer.pdf %% ============== Paper Size (in inches) =================== %% % You can specify the paper (page) size in inches. pageheight=11 %% ============== Space Size ========================= %% % You can increase the space between characters by increasing % the value of widthScaleRate and between lines by increasing % the value of heightScaleRate. Pasta/IX will subset and embed % the font in the Postscript output file and send it to your % Postscript printer.25 rightMargin=0. topMargin=0.27 pageheight=11.0.25 bottomMargin=0.0. % [A4] pagewidth=8. Pasta will replace it with the actual % input file name (without the path) specified by the '-f' % (input file) command line option. Oracle provides Andale fonts (ADUO*. % If you specify a TrueType font. preprocess=ps2pdf {infile} {outfile} .64 % [Letter] % If you want to use Letter as the default paper size. You can use {inputfile} % in the outFile option. noPrint=y . Use the outFile % option or the '-o' (output file name) command line option to % store the output file wherever you like. 10. if your printer has a font installed that % is suitable for the language of your report.g. You % can alter the number of spaces using this option. Your printer does not need to have any % fonts installed. pagewidth=8. If you want % to use a different paper size for a particular language or % territory.5). % You can specify any number (e. Pagewidth % specifies width and pageheight specifies height. comment % the A4 settings above and uncomment the following lines: .0 heightScaleRate=1.0 %% ============== Margins (in inches) =================== %% % These settings should be changed to suitable values for your % printer. widthScaleRate=1. tabsize=8 %% ============== Font Size (in points) =================== %% % This value affects all of the fonts you use in your reports. fontsize=9 %% ============== Font Name ========================= %% % You can use any TrueType fonts on your middle tier server.25 %% ============== Tab Size (in spaces) =================== %% % Pasta replaces a tab with a specified number of spaces. you can utilize Pasta Users’ Guide .25 leftMargin=0.

% For example. Font. % Pasta will send the report multiple times up to the number of % copies.ttf % Uncomment the following if you want to use printer fonts as a % default. 123123) or uncollated % (e.g.<Face>.Default.g.Bold=<FND_TOP>/<APPLRSC>/ADUOB. .<Style>=<TrueType font file name> % or % Font. you can eliminate % the header page normally printed between reports. the output will be: % % | embednumcopies Pasta Users’ Guide .Default.Bold = printer:Courier-Bold %% ============== Printing Command ==================== %% % You can specify the printing command and options you want % to use to print your report. % %The <Style> must be either "Plain".Plain=<FND_TOP>/<APPLRSC>/ADUO. you can choose to % have the copies collated (e. If you set % "embednumcopies" to "n". the order is always 123123. "Italic" and "BoldItalic" % work only for bitmap reports.Default.<Face>. "Plain" and "Bold" work % for text reports and bitmap reports. All printers have the Courier font installed by default.<Style>=printer:<Printer font name> % % The <Face> must be either "Default" or the actual font face % name. used in your report. please set this option to "n". such as "Helvetica". % "Bold". embednumcopies=y % Collate [y|n] % % If you set "embednumcopies" to "y" above. Pasta will pass the final output % to this command. 112233) by setting the "copysort" option.ttf Font. However. if you want to print two copies of a report % that has 3 pages. some other printers do not support % the command.Plain = printer:Courier . Font. "Italic" or "BoldItalic". In that case. % % The form of this option is: % Font. Actual font face % names work only for bitmap reports. % for UNIX platform printCommand=lp -c -d{printername} % for Windows platform ntPrintCommand=print /D:{printername} %% ============== Printing Options ===================== %% % Embed number of copies [y|n] % % You can embed the number of copies to be printed in a % Postscript file. Font. % Courier has glyphs for Western European characters. {printername} will be replaced by the % actual printer name passed through the command line option % (-pn).% the printer font. "Default" % works for text reports and bitmap reports. By embedding the number of copies. so in most cases you don't have to change these % options.Default.

% |y n % -----------------------------% copysort y | H123123 H123H123 % copysort n | H112233 H123H123 % % where "H" stands for a header and "123" stands for 1st page. Pasta can automatically detect Thai characters. it is rtl. please refer to the following site. If NLS_LANGUAGE is % Arabic or Hebrew. For information about the Unicode BiDi % algorithm. Otherwise.unicode. some characters are combined into one % glyph. If you want to use it.html % % For backward compatibility. bidi_algorithm=unicode %% ============== Thai Specific Options ==================== %% % Space compensation for Thai [y|n] % % In the Thai language. it is ltr. Pasta/IX still supports Oracle's % original algorithm. duplex=default %% ============== BiDi Specific Options ================= %% % The following options work only for Bi-Directionallanguages % such as Arabic or Hebrew. "default" means that it depends % on the printer-side setting. copysort=y % Duplex printing [y|n|default] % % You can specify duplex or not. direction=default % Do string layout [y|n] dolayout=y % Do Arabic shaping [y|n] doshaping=y % numerals [arabic|hindi|context] % % arabic: To always use Arabic numerals % hindi: To always use Hindi numerals % context: To use Arabic or Hindi depending on the context numerals=context % Bidi layouting algorithm [oracle|unicode] % % If you set this option to "unicode". % http://www. Pasta Users’ Guide . Pasta will % align your report by adding spaces at the end of any string % that includes combined characters. This option works only for % Thai characters. % Global direction [ltr|rtl|default] % % ltr: Left-To-Right % rtl: Right-To-Left % default: It depends on NLS_LANGUAGE. If thai_space_compensation is set to "y". % 2nd page and 3rd page. please set % this option to "oracle". Pasta/IX follows the % Unicode BiDi algorithm.org/unicode/reports/tr9/index.

FRENCH.Italic = printer:Courier-Oblique Font.BoldItalic = printer:Symbol Font.ICELANDIC.ttf Font.Times.Plain=<FND_TOP>/<APPLRSC>/ADUOSC. which overrides the setting % here.Symbol.Bold = printer:Courier-Bold Font.Courier.DANISH.Helvetica.Symbol.% so it is safe to set this option to "y" for languages other % than Thai.Symbol.BRAZILIAN PORTUGUESE.Times.GERMAN.SPANISH. However.Default.Plain = printer:Helvetica Font.Italic = printer:Symbol Font. In this configuration file. % --.Plain Font.FINNISH] Font.CANADIAN FRENCH.Helvetica.NORWEGIAN.Helvetica.log %%%% ============== Language Specific Settings ============= %%%% %%%% Each language section is specified by [{NLS_LANGUAGE}] where %%%% {NLS_LANGUAGE} is the Oracle language name.BoldItalic = printer:Courier-BoldOblique Font. this option is set to % "y" only in the Thai section below.Courier.Default.Times.Bold = printer:Times-Bold Font.Italic = printer:Times-Italic Font.Plain = printer:Symbol Font.Courier. The default error % output is stderr. .LATIN AMERICAN SPANISH.Symbol.SWEDISH.Plain = printer:Courier Font.Bold=<FND_TOP>/<APPLRSC>/ADUOSCB.Bold = printer:Symbol Font.Courier. it may affect performance because Pasta % checks whether space compensation is necessary or not for all % characters. thai_space_compensation=n %% ============== Error Log File ======================== %% % This tells Pasta to create a log file.Plain = printer:Times-Roman Font.ttf Pasta Users’ Guide .PORTUGUESE.ENGLISH.ITALIAN.Default.Italic = printer:Helvetica-Oblique Font.CATALAN.BoldItalic = printer:Helvetica-BoldOblique Font.Default.Default.errorlogfile=pasta.Default.BoldItalic = printer:Times-BoldItalic % --.End of the settings for bitmap reports --%% For Simplified Chinese [SIMPLIFIED CHINESE] Font. %%%% One section name can contain multiple languages separated by %%%% commas.Bold = printer:Helvetica-Bold Font. %% For Western European (Latin-1) languages [AMERICAN.Start of the settings for bitmap reports --Font.Helvetica.Times.DUTCH.BoldItalic = printer:Courier-BoldOblique Font.Italic = printer:Courier-Oblique Font.Bold = printer:Courier = printer:Courier-Bold % The following settings are necessary for bitmap reports only.

%%%% One section name can contain multiple territories separated by %%%% commas. It works with Oracle Reports/Toolkit % and enables you to print a bitmap (Postscript) report that contains % any characters from any languages.5 (or later) and IX 1. % which are included in both Pasta and the IX Library.Default.2.Plain=<FND_TOP>/<APPLRSC>/ADUOTC.ttf Font. .Bold=<FND_TOP>/<APPLRSC>/ADUOJB.ttf Font. % % This file is for Pasta 2.Default.Default. % The Pasta executable includes IX and utilizes its features.ttf %% For Korean [KOREAN] Font. please uncomment the % following line.%% For Traditional Chinese [TRADITIONAL CHINESE] Font.5 includes IX 1.Default.ttf %% For Japanese [JAPANESE] Font. outputFormat=text.Plain=<FND_TOP>/<APPLRSC>/ADUOK.2. You can use the same configuration file for both Pasta Users’ Guide . IX consists of the engines that drive Pasta.TH8TISASCII %%%% =============== Territory Specific Settings ============ %%%% %%%% Each territory section is specified by [_{NLS_TERRITORY}] where %%%% {NLS_TERRITORY} is the Oracle territory name.Default.Plain=<FND_TOP>/<APPLRSC>/ADUOJ. Also. It % includes a font handling engine. Pasta % 2._CANADA] % [Letter] pagewidth=8. %% For America and Canada regions [_AMERICA.5 pageheight=11 %%%% ================= Notes ======================== %%%% % Pasta is a product that is part of the E-Business Suite's Application % Object Library (FND). The term "IX" refers to the engines.Bold=<FND_TOP>/<APPLRSC>/ADUOTCB.Bold=<FND_TOP>/<APPLRSC>/ADUOKB.ttf %% For Thai [THAI] thai_space_compensation=y % If you need text output for Thai. It is provided as an executable named FNDPSTAX % and enables you to print a text report that contains any characters % from any languages. Developer 6i Patchset 11 includes % IX Library 1. a language handling engine and so on.2 (or later).Default. % % IX is also released as part of a library (IX Library) with Developer % 6i Patchsets since Patchset 9.ttf Font.

In this sample file we are using a % for % commentary and a . % % The default name of the configuration file is "pasta.cfg". You can specify any % environment variable. % % You can use either a / (slash) or a \ (backslash) as the delimiter in % a file path. % For example. Edit the configuration file to meet your requirement. Section names are case insensitive. % % Any variable that starts with a < (less-than) and ends with a > % (greater-than) is an environment variable. The language and territory sections are optional.ghostscipt. If you % want to override the options in the [DEFAULT] section according to % languages and territories. % % 1.cfg to % $FND_TOP/resource/pasta_<yourprinter>.cfg" first and then % search for "pcl. PASTA will try to read $FND_TOP/resource/pasta_<yourprinter>. Pasta % will search for the file named "pcl_<your printer>. Each language section is specified by [{NLS_LANGUAGE}] where % {NLS_LANGUAGE} is the Oracle language name. % %% The following notes apply only to Pasta. % % 3. % % 2. % % Any line that starts with a % (percent) or a . Also. please refer to http://www. not to the IX Library. Pasta Users’ Guide . Pasta/IX will replace the environment variable % with the actual value at runtime.cfg % first and if the file is not found then will try to read % $FND_TOP/resource/pasta. if you need to print in PCL then uncomment the % preprocess option for PCL printing and make necessary changes % for the parameters of Ghostscript if needed.cfg". You can % override it by using the '-F' (configuration file) command line option. Copy $FND_TOP/resource/pasta. for options that you may want to enable. A section % starts with a [ (left square bracket) and ends with a ] (right square % bracket). it is very easy to have a specific configuration file % for each printer. if you specify "-Fpcl.cfg where <yourprinter> % will be the printer name you define on the operating system and % in the E-Business Suite (both should be the same name). (semi-colon) is a % comment and is ignored. % Regarding Ghostscript. Pasta/IX will use an % appropriate delimiter automatically according to platform. % % If you have multiple printers registered and you need a specific setup % for each printer. Each territory section is % specified by [_{NLS_TERRITORY}] where {NLS_TERRITORY} is Oracle % territory name.cfg" in the command line. you can add multiple language and territory % sections. % For example. or you can use separate ones.com. you can specify both {NLS_LANGUAGE} and % {NLS_TERRITORY} at the same time as [{NLS_LANGUAGE}_{NLS_TERRITORY}]. regardless of the platform. % One section name can contain multiple languages and/or territories % separated by commas. The [DEFAULT] section % is mandatory. % % The configuration options are grouped into sections.cfg. This is an example for supporting a PCL printer.% Pasta and IX Library.

Sign up to vote on this title
UsefulNot useful

Master Your Semester with Scribd & The New York Times

Special offer for students: Only $4.99/month.

Master Your Semester with a Special Offer from Scribd & The New York Times

Cancel anytime.