AFP2PDF Plus Transform User's Guide

74 Pages·2017·0.77 MB·English

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