RICOH InfoPrint XT for Windows Installing and Using Introducing InfoPrint XT 1 Installing and configuring InfoPrint XT 2 Version 3.4.0.0 InfoPrint Manager configuration tasks 3 RICOH ProcessDirector configuration tasks 4 Customizing InfoPrint XT 5 Copying and loading Xerox resources 6 Submitting Xerox jobs for data stream conversion 7 Transferring jobs with Download for z/OS 8 Troubleshooting InfoPrint XT 9 Conversion parameters for Xerox jobs 10 Messages 11 Return codes 12 InfoPrint XT Custom Color Collections 13 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. Note: Before using this information and the product it supports, read the information in the Notices section. Seventh Edition (June 2021) This edition applies to InfoPrint XT for Windows, Version 3.4.0.0, Program Number 5765-XTA, and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces G550-1340-05. Internet Visit our home page: http://rpp.ricoh-usa.com/ You can send comments by e-mail to [email protected] or by mail to: Ricoh Company, Ltd. 6300 Diagonal Hwy 004 Boulder, CO 80301-9270 U.S.A. This product is or contains commercial computer software and commercial computer software documentation developed exclusively at private expense. As specified in Federal Acquisition Regulation 12.212 in the case of civilian agencies and Defense Federal Acquisition Regulation Supplement 227.7202 in the case of military agencies, use, duplication and disclosure by agencies of the U.S. Government shall solely be in accordance with the accompanying Software License Agreement in case of software products and in accordance with the licensing terms specified in the product's documentation in the case of hardware products. 1 2 TABLE OF CONTENTS About this publication ......................................................................................................................... 9 Related Information ..........................................................................................................................11 1 Introducing InfoPrint XT InfoPrint XT overview............................................................................................................................13 Benefits of using AFP and InfoPrint XT ...............................................................................................13 Xerox resources and the InfoPrint XT load process ...............................................................................13 Printable Xerox resources .................................................................................................................14 Non-printable Xerox resources that InfoPrint XT uses ........................................................................14 Non-printable Xerox resources that InfoPrint XT does not use ...........................................................15 Xerox data stream conversion and Dynamic Job Descriptor Entries ..................................................15 Methods of sending jobs to the Windows system and submitting them to InfoPrint XT........................16 Highlight color processing ................................................................................................................17 Ink correlation table organization.....................................................................................................17 Xerox job restrictions ........................................................................................................................18 Other restrictions ..............................................................................................................................22 Double-byte character set (DBCS) support .......................................................................................23 Supported and unsupported Xerox DJDE and PDL commands..........................................................23 2 Installing and configuring InfoPrint XT Software requirements .........................................................................................................................27 Hardware requirements....................................................................................................................28 Optional printer driver software........................................................................................................28 Installing InfoPrint XT ............................................................................................................................29 Installing InfoPrint XT in demo mode .................................................................................................30 Applying license keys and files to an InfoPrint XT installation ............................................................33 Testing the InfoPrint XT installation........................................................................................................37 Testing with the pdxtloadres and pdxtx2afp commands ...................................................................37 To test the InfoPrint Manager and InfoPrint XT installation .................................................................38 To test the RICOH ProcessDirector and InfoPrint XT installation .........................................................39 Uninstalling InfoPrint XT........................................................................................................................42 Installing pdxtdownload for Linux ........................................................................................................43 Uninstalling pdxtdownload for Linux ....................................................................................................44 3 InfoPrint Manager configuration tasks Creating the InfoPrint XT configurable transform...................................................................................45 Usage notes .....................................................................................................................................45 Return codes from the pdxtcrtxform command ..................................................................................46 3 Using the pdxtsetdest command to update InfoPrint Manager actual destinations................................46 Usage notes .....................................................................................................................................47 Streams used by the pdxtsetdest command.......................................................................................47 Return codes from the pdxtsetdest command ....................................................................................47 4 RICOH ProcessDirector configuration tasks 5 Customizing InfoPrint XT Terms used in this chapter ....................................................................................................................53 Setting environment variables ..............................................................................................................53 Controlling the working directory that InfoPrint XT uses for variable data (PDXTWORKDIR)..............54 Controlling the default arguments when you load resources (PDXTLOADRES_ARGS) ......................54 Controlling the default arguments when you process jobs (PDXTX2AFP_ARGS) ...............................55 Controlling the default arguments when you create and modify cluster database resources (PDXTCLUSTER_ARGS) ................................................................................................................55 Controlling the default arguments when you compile JSLs (PDXTPDL_ARGS)....................................56 Controlling resource-load messages for FILE DJDE jobs (PDXT_AIOLXDFE_TRACE) .........................56 Activating trace functions for the font converter (PDXT_XR2FAPI_TRACE) .........................................56 Activating trace functions for the image and logo converter (PDXT_XR2IAPI_TRACE).......................57 Activating trace functions for the form converter (PDXT_XR2RAPI_TRACE)........................................57 Controlling the default arguments when you process the ink correlation table (PDXTCOLOR_ ARGS) ..........................................................................................................................................57 Controlling the content of error messages (PDXT_INTMSGIDS)........................................................58 Controlling the format of the error sheet (PDXT_MSGxxxxxxx)...........................................................58 Environment variables for directives..................................................................................................59 Creating a custom parameter mapping file ..........................................................................................59 Parameter mapping file syntax rules .................................................................................................60 Verifying the parameter specification of the mapping file..................................................................63 Using transform directives ....................................................................................................................63 Working with the base InfoPrint XT application exits ............................................................................66 Setting up a transform accounting