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

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

Pasta will automatically detect the format and pass it to a preprocess command without any modification. 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 supports two output formats: Postscript and text. New Features in 2. If you specify type42. PDF File Support as Input Pasta 2. If you use Type42 and convert a Postscript file generated by Pasta to a PDF file. Pasta 3. the characters in the PDF file will be displayed in better quality. If the input is a text file. set the “outputFormat” option to "ps”.5 accepted only text and PostScript format as input.5 Pasta supports the following features in version 2.5: • • • • • • • • • • • • • • Output Formats Currently. If the input file is a PDF file. "psEmbeddedFontType=[type3|type42]". Pasta will convert it to a Postscript file.Please refer to the chapter of “Barcode TrueType Font Support” for more detailed information. 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. Pasta will use PostScript Type42 when embedding font. Type42 is suitable for displaying as well as printing. Type3 is suitable for printing but not for displaying.0 now accepts PDF as an input file format as well. If you have a Postscript Level 2 (or higher) printer. The result from the preprocess command will be sent to the print command specified in printCommand option. PostScript Type3 font is the current type of font that is used for font embedding.

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

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

pasta.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. For example: outFile=<APPLTMP>/{inputfile}. You can use any TrueType font that resides on your middle tier server. you can utilize the printer font.ttf) for printing. 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. WidthScaleRate (-w) option will not take effect when printer font is used. 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. you can configure a printer with very minimal manual step. If you specify a TrueType font. You can use {inputfile} in the “outFile” option. Your printer need not have any fonts installed. Pasta can support Latin1 characters only for this option at thismoment.pdf If you want to specify the output file name in the command line. Printer Fonts (Latin 1) Support as well as TrueType Fonts Pasta now supports fonts installed on the printer as well as TrueType font file. 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. Pasta will replace it with the actual input file name (without the path) specified by the ‘-f’ (input file name) command line option. If your printer has a font installed that is suitable for the language of your report. Pasta Users’ Guide . The default error output is “stderr” (standard error). Oracle provides Andale fonts (ADUO*. so Pasta errors are logged in the Concurrent Manager log file. By using these pre-defined settings. you can use the existing ‘-o’ (output file name) command line option. Pasta will subset and embed the required characters from the font in the Postscript output file and send it to your Postscript printer.

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

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

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

PRINTER c$PROFILES$CONC_COPIES -1 -f$PROFILES$.FILENAME Note that the arguments must be written in one line. Landwide Driver Driver Name: PASTA_LANDWIDE User Driver: Pasta Landwide Driver SRW Driver: W Program Name: FNDPSTAX Arguments: -pn$PROFILES$.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$.FILENAME Note that the arguments must be written in one line.FILENAME Note that the arguments must be written in one line. 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$.PRINTER c$PROFILES$.CONC_COPIES -f$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 .PRINTER c$PROFILES$CONC_COPIES -1 -f$PROFILES$.

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.

Pasta provides a solution. Pasta Users’ Guide . 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.prt or W. 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. L.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.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 Files Setup Make sure to include the following lines in SRW driver file (prt file) such as P.prt. which are Hebrew and Arabic. you need additional settings in prt file. For example.

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

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

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

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

Create a set of printer drivers for each printer style with the configuration file created above. It has been very difficult to achieve this type of customization. Register your printer with the printer style. Create a printer type for each server in Oracle Applications. This parameter will be replaced by Pasta at runtime with actual printer name. 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. You can specify full path to the command if you maintain both System V lp command and CUPS lp command. if printer1 is defined on the server CUPS1 and you have created Pasta printer CUPS1 printer type for the server.000 rdf files and also they had to repeat the modification every time they apply the patch or upgrade the software.Make sure that the lp command is a CUPS lp command.FILENAME c$PROFILES$. Example: Printer Type: Pasta printer for CUPS1 Printer Style Printer Driver ------------. Example: Printer Driver Name: PASTA_LANDSCAPE_CUPS1 Arguments: -pn$PROFILES$. Example: Pasta printer CUPS1. Leave {printername} as it is. 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. For example. 4. For example a customer might need those graphical images to follow the customer's corporate identity standard.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.CONC_COPIES -l -Fpasta_cups1.--------------------LANDSCAPE PASTA_LANDSCAPE_CUPS1 PORTRAIT PASTA_PORTRAIT_CUPS1 LANDWIDE PASTA_LANDWIDE_CUPS1 5. PASTA_PORTRAIT or PASTA_LANDWIDE. It is true that there are some third party tools to help the customers who have this Pasta Users’ Guide .PRINTER -f$PROFILES$. Pasta printer CUPS2 and Pasta printer CUPS3 Add required styles associated with the printer drivers to the printer type. 3. For example.

the customers don't have to edit or modify their original report any more. Note that the way to deploy the PrintForm to Oracle Applications might be changed in the future. Overview of Creating a PrintForm There are two phases to apply PrintForm technology to Oracle Applications. the report has to be printed out every time a positional attribute is changed. With this new feature. They just need to pass a PostScript file with a background image when they call Pasta. Create the PrintForm Choose an Editor and conversion mechanism Pasta Users’ Guide . 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. and generate one PostScript file. This has been causing very expensive cost to the customers. Pasta utilizes the PostScript technology so there is also no printer specific knowledge is required as long as the printer supports the PostScript language. The PrintForm also provides the better solution that can replace the pre-printed stationery solution. The function is called PrintForm function and the PostScript file with a background image is called the PrintForm.etc for every printer.. 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. space between the lines. pitches. In addition. Pasta converts an input file to PostScript internally and this PrintForm function reads another file. 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. the pre-printed stationery is no more required. There has been another requirement that some customers need to print a concurrent report on top of the pre-printed stationery.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. to fit the report in the correct position in the paper. The second phase is to deploy the PrintForm to Oracle Applications as a part of the Concurrent Processing mechanism. Because of the fact that stationery can be generated in electronic form by this feature. which contains a background image for example. This task is very hard because every customer has to arrange the position of the report in the paper by changing margins..

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

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

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

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

pdf oracle_ls. Go to File -> Print menu in your application 2. For example: $ pdftops oracle_ls. Hitting the OK button will lead you to save the file. 3.Run pdftops command by Xpdf to convert the PDF file to PostScript file.ps oracle_ls. make sure printer name is "Generic PostScript Printer" and the check box for Print to file option is checked. 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 Adobe Generic PostScript Printer Driver 1. For example: $ FNDPSTAX -pform oracle_ls. In the Print window.pf Note that this program is only available on the computer that Oracle Applications is installed. Pasta Users’ Guide . 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. Use Adobes' Generic PostScript Printer to save the file in PostScript format. 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.

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

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

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

Japanese. N/A Arabic. the European characters must be Pasta Users’ Guide . or “context” to use Arabic or Hindi depending on the context. some characters are combined into one glyph. You can specify the printer options using printCommand and ntPrintCommand instead. If you set this option to “unicode”. Key Name Values Description Command Line Equivalent N/A thai_space_compensation y n (*) In the Thai language. Hebrew and Thai Options An asterisk (*) in the values column indicates the default value. set this option to “y”.Defalt” option contains CJK (Chinese. 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. 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. To lay out the text. Pasta follows the Unicode BiDi algorithm. Note: This option remains for backward compatibility but will be obsolete in future releases. Required for Arabic data only. If this option is set to “y”. and “default” (depends on the NLS_LANGUAGE setting). set it to “n”.printCommandOptions Print command options You can specify printer options with this setting. If no shaping is required. Options are “ltr” (left-to-right). “rtl” (right-to-left). If no layout is required. set it to “n”. This option is for Arabic only. Possible values are “arabic” for Arabic numerals. “hindi” for Hindi numerals. set this option to “y”. CJK Ideographs If the TrueType font you specified for the “Font. To shape the text. Korean) Ideographs.

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

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[.WE8ISO8859P1). Two output formats are supported: Postscript (“ps”) and text (“text”). Displays the Pasta version number. When the output format is text.auto). Pasta uses the appropriate character set according to the NLS_LANGUAGE value in the FND_LANGUAGES table. <pf file> specifies a PrintForm file to be merged in a Pasta output at runtime. <printername> specifies the printer name. Banner option for use with the Unix lp command. you can specify the output character set by the Oracle character set name (for example. <banner title> is passed to the lp command with the -t lp command option. Specifies the output format. Here are the default character set values taken from the FND_LANGUAGES table. If you use”auto” as the output character set (text. <width> specifies the paper width in inches. Converts a PostScript file <ps file> to a PrintForm file <pf file>.charset|Auto]> Pasta Users’ Guide .-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. text. <height> specifies the paper height in inches.

cfg. -C<number> <number> specifies the maximum number of columns.ps -np 3) To print a report with font size 10 > FNDPSTAX -fmyfile.txt -s10 Font Files Provided by Oracle This is a list of ten files that are bundled with Pasta patch. <printer options> specifies the printer name and options.txt > FNDPSTAX -fmyfile.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. Use the new ‘-pn’ option instead. Pasta Users’ Guide . -P<printer options> Examples: 1) To check the version number > FNDPSTAX -v 2) To generate myfile.txt –omyfile. Note: This option remains for backward compatibility but will be obsolete in future releases. Do not use this option.ps from myfile. The maximum number of columns is controlled by SRW driver files. Note: This option remains for backward compatibility but will be obsolete in future releases. the format of the report file will break. If Pasta changes the value.

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

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

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

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

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

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

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

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

Sign up to vote on this title
UsefulNot useful