Data Transforms AFP2PDF Plus Transform Overview 1 User’s Guide Installing AFP2PDF Plus Transform 2 Architecture and Configuration Version 1.016 3 Using the AFP2PDF Plus Transform 4 Using the AFP2PDF Plus Utility Programs 5 Working with AFP Resources 6 Working with AFP Images 7 JAVA Application Programming Interfaces 8 Comparison with AFP2PDF Transform 9 For information not in this manual, refer to the Help System in your product. Read this manual carefully and keep it handy for future reference. About This Publication Thispublicationuses the followingsymbols: Bold Bold type indicatesthe namesof commandsand parameters. Boldunderline Underlinedbold type indicatesthe defaultvalue. Italic Italictype indicatesvariablesthat youmust replacewithyourown information. Monospace Monospacetype indicatescomputerinputand outputand filenames. [ ] Squarebracketsindicatethata valueis optional. | A verticalbar indicatesa choicebetweenvalues. ... An ellipsisindicatesthata seriescan continue. 1 2 TABLE OF CONTENTS About This Publication 1 Overview Benefits .................................................................................................................................................. 5 Limitations .............................................................................................................................................. 5 2 Installing AFP2PDF Plus Transform Upgrading from AFP2PDF to AFP2PDF Plus Transform ........................................................................... 8 Installing AFP2PDF Plus Transform on a Windows Server....................................................................... 8 Installing AFP2PDF Plus Transform on a UNIX Server ............................................................................. 9 Installing AFP2PDF Plus Transform with OnDemand ............................................................................... 9 Installing AFP2PDF Plus Transform with Content Navigator ..................................................................10 3 Architecture and Configuration Architecture..........................................................................................................................................11 Configuration.......................................................................................................................................12 Configuring the server.cfg File .................................................................................................12 Configuring the logging.properties File ..............................................................................13 AFP2PDF Plus Transform Security .........................................................................................................15 Encryption ........................................................................................................................................15 Certificate Signatures........................................................................................................................16 4 Using the AFP2PDF Plus Transform Starting and Stopping the AFP2PDF Plus Server on a Windows Server ................................................17 Starting and Stopping the AFP2PDF Plus Server on a UNIX Server ......................................................17 AFP2PDF Plus Transform Command .....................................................................................................17 Syntax ..............................................................................................................................................17 Parameters .......................................................................................................................................18 Return Codes....................................................................................................................................21 AFP2PDF Plus Transform Options File...................................................................................................21 Working with AFP Visual Environment Control Files..............................................................................29 5 Using the AFP2PDF Plus Utility Programs split_afp2pdf Command ......................................................................................................................31 Syntax ..............................................................................................................................................31 Parameters .......................................................................................................................................31 The XML Format of Output TLE Information when -tle is Specified .....................................................34 Return Codes....................................................................................................................................34 ArchiveLoad_afp2pdf Command.........................................................................................................35 3 Syntax ..............................................................................................................................................35 Parameters .......................................................................................................................................35 6 Working with AFP Resources Files Supplied for Mapping Fonts.........................................................................................................40 Coded Font Files...............................................................................................................................41 Character Set Definition File ............................................................................................................42 Code Page Definition File .................................................................................................................44 Code Page File Map ........................................................................................................................46 Alias File...........................................................................................................................................47 Font Mapping File ............................................................................................................................47 Process for Mapping Fonts...................................................................................................................48 Using Custom AFP Raster Font Files......................................................................................................49 Using Custom Font Metric Files ............................................................................................................49 Mapping AFP Fonts to Type 1 Fonts.....................................................................................................51 Mapping AFP Fonts to TrueType Fonts .................................................................................................52 Using AFP TrueType Fonts ....................................................................................................................52 Using User Defined Characters within a DBCS Font .............................................................................52 Character encoding.............................................................................................................................52 7 Working with AFP Images 8 JAVA Application Programming Interfaces 9 Comparison with AFP2PDF Transform INDEX 4 1. Overview •Benefits •Limitations The AFP2PDF Plus Transform coverts Advanced Function Presentation (AFP) documents into Adobe Acrobat Portable Document Format (PDF) files by exactly mapping AFP format to PDF format. 1 The AFP2PDF Plus Transform lets you: • Operate on any system that supports JAVA Version 1.6 or later. • View documents with the same fidelity as if they were printed. If the Adobe Acrobat plug-in is installed with a Web browser, you can view and print these documents within the browser application. • Use configuration files to customize how AFP documents are transformed. • Fully integrate with the IBM Content Manager OnDemand Web Enablement Kit and the IBM Content Navigator. Benefits The AFP2PDFPlus Transformgivesyou theseaddedbenefits: • Client/Serverimplementation. • GreatlyimprovedtransformationspeedoverAFP2PDF(5876-W01). • Largerthan2–GB inputand outputfile support. • Reducecostsassociatedwithprintingandmailingby deliveringdocumentselectronically. • Quicklyretrieveyour informationwithinmulti-pagedocumentsusingAdobeAcrobatsearchand navigationfeatures. • PrintAFP2PDFPlus Transformdocumentson any localprinterusingthe printfunctionin Adobe Acrobat. • Increasecontroloveryour informationwithan addedlayerof securityand encryption.To control modification,copying,and printing,definean ownerpassword;definean end-userpasswordto controldocumentaccess;and add a digitalsignatureto providemoresecurity. Limitations The currentlimitationsof the AFP2PDFPlus Transforminclude: • The followingset of bar codesis generatedin the outputPDFwhenusingthe Bar CodeObject ContentArchitecture(BCOCA)in AFP data.Any otherbar codesare ignoredduringconversion. – Codabar,2-of-7,AIMUSS-Codabar – Code39 (3-of-9Code),AIMUSS-39 – Code128,AIMUSS-128 – DataMatrix – Interleaved2-of-5,AIMUSS-I2/5 – PDF417 – POSTNET – QR code 5 1 Overview – USPS Four-State—Intelligent Mail Barcode (IMB) – Japan Postal Barcode – Royal Mail Mailmark Barcode • When AFP data formatted for N-up portioning is encountered, the multiple partitions that make up the physical AFP page are converted to separate pages in the PDF file. 1 • Only limited support is available for object containers with TIFF and JFIF image formats. • Color management resource (CMR) information contained in AFP resources is ignored. • Unicode Complex Text, such as bidirectional layout processing and glyph processing, is not supported. • TrueType font collections, linked TrueType fonts, and the use of a Resource Access Table (RAT) are not supported. 6 2. Installing AFP2PDF Plus Transform •Upgrading from AFP2PDF to AFP2PDF Plus Transform •Installing AFP2PDF Plus Transform on a Windows Server •Installing AFP2PDF Plus Transform on a UNIX Server •Installing AFP2PDF Plus Transform with OnDemand •Installing AFP2PDF Plus Transform with Content Navigator AFP2PDF Plus Transform has a different architecture from the AFP2PDF Transform. AFP2PDF Plus Transform Architecture 2 Since the new AFP2PDF Plus for JAVA Transform is designed to integrate seamlessly with existing AFP2PDF installations, it has both client and server functions. The transform client is a C/C++ command-line program that has parameters identical to the current AFP2PDF Transform. The transform server is JAVA-based and performs various functions: • Accepts requests from the transform client for document conversion • Keeps the JAVA Virtual Machine (JVM) active without starting and stopping after each conversion • Spawns a thread for each document to be converted, taking advantage of multi-core processors These are the transform client and server requirements and end-user client requirements for the AFP2PDF Plus Transform: • Transform client requirements: – HP-UX 11.3 or later – IBM AIX 6.1 or later – IBM z/OS UNIX System Services V1.13 or later – Microsoft Windows 7 Professional or later 7 2 InstallingAFP2PDFPlusTransform – Microsoft Windows Server 2008 SP2 or later – Linux Kernel 2.6.18 or later (x86) – Linux Kernel 2.6.09 or later (IBM System z) – Oracle Solaris 10.9 or later (SPARC only) • Transform server requirements: JAVA V1.6 or later • End-user client requirements: Adobe Acrobat, Acrobat Reader, or Acrobat Plug-In 9.0 or later 2 Upgrading from AFP2PDF to AFP2PDF Plus Transform The Java jar file,Upgrade.jar,is an executableprogramthat upgradesC/C++AFP2PDFtransform to AFP2PDFplus. Upgrade.jarperformsthesestepsto upgradefromAFP2PDFtransformto AFP2PDFplus: 1. Backsup executablemodulesin C/C++AFP2PDFtransform: 1) Createsa nativebackupfolderin the C/C++AFP2PDFinstalldirectory.If the native_ backup\folderexists,the backupfoldernameappends“-1”,that is, native_backup-1 \. Themaximaliterationof appendingis 9 timesof ”-1”. 2) Movesall existinglicense\foldear nd java_api\foldeirn C/C++installdirectoryto the backup folder. 3) Movesall AFP2PDF*and split_afp2pdf*to the backupdirectory. 2. CopiesAFP2PDFplusmodules,documents,serverconfigurationfileand propertyfilesto the C/C++ AFP2PDFinstalldirectory: 1) CopiesAFP2PDFor AFP2PDF.exeto the C/C++AFP2PDFinstalldirectory. 2) Copies*. jar filesto the C/C++AFP2PDFinstalldirectory. 3) CopiesLICENSE/*to the C/C++AFP2PDFinstalldirectory. 4) Copies*.shor *.batto the C/C++AFP2PDFinstalldirectory. 5) Copies*.propertiesto the C/C++AFP2PDFinstalldirectory. 6) CopiesServer.cfgto the C/C++AFP2PDFinstalldirectory. 7) CopiesAFP2PDF_Plus_UG.pdtof the C/C++AFP2PDFinstalldirectory. Usage The jar fileUpgrade.jarmustbe in the AFP2PDFplusdirectory.From the AFP2PDFplus directory,run the command:java–jarUpgrade.jar<C/C++afp2pdfinstall directory>.If no parameteris given,thismessageis displayed:UpgradetheC/C++AFP2PDF transformto Java transform(AFP2PDFPlus). You need to run the jar fileUpgrade.jarin the AFP2PDFPlus installeddirectory. Installing AFP2PDF Plus Transform on a Windows Server ForWindowsoperatingsystems,the AFP2PDFPlus Transformprogramis deliveredin a ZIP filewith the filename in this format: 8