Ricoh GLD0-0025-01 manual

InfoPrint XT for Windows:

Installation Guide and User’s Guide

Ve r s i o n 2 Release 1

GLD0-0025-01

Contents

Main InfoPrint XT for Windows: Installati on Guide and U sers Guide Ve r s i o n 2 Release 1 GLD0-0025-01 Page InfoPrint XT for Windows: Installati on Guide and U sers Guide Ve r s i o n 2 Release 1 GLD0-0025-01 Page Contents Summary of changes . . . . . . . .xv Chapter 1. Introducing InfoPrint XT . . .1 Chapter 2. Installing and configuring InfoPrint XT . . . . . . . . . . . . .11 Chapter 3. Customizing InfoPrint XT . .21 Chapter 4. Loading Xerox resources . .37 Chapter 5. Submitting Xerox jobs for data stream conversion . . . . . . .59 iv Chapter 6. Transferring jobs with Download for z/OS . . . . . . . . .67 Chapter 7. Troubleshooting InfoPrint XT . . . . . . . . . . . . . . . . .83 Return code numbers . . . . . . . . . . .113 Index . . . . . . . . . . . . . . . 173 Contents v Page Figures Copyright InfoPrint Solutions Company 2004, 2007 Page Tables Page About this publication Who should use this publication How this publication is organized Copyright InfoPrint Solutions Company 2004, 2007 Conventions used in this publication xii Highlighting Understanding the syntax notation and the use of special characters Entering commands that this publication describes Related information Other sources of information that you can use with InfoPrint XT are: Web sites InfoPrint XT manual (man) pages xiv pdxtman pdxt Summary of changes Copyright InfoPrint Solutions Company 2004, 2007 xvi Summary of changes xvii xviii updates are not marked with revision bars. Chapter 1. Introducing InfoPrint XT InfoPrint XT overview Benefitting from AFP and InfoPrint XT Xerox resources and the InfoPrint XT load process Copyright InfoPrint Solutions Company 2004, 2007 Printable Xerox resources 2 Non-printable Xerox resources that InfoPrint XT uses v InfoPrint XT resource utility messages on page 121 Non-printable Xerox resources that InfoPrint XT does not use Chapter 1. Introducing InfoPrint XT 3 Xerox data stream conversion Xerox START commands and InfoPrint XT conversion parameters Dynamic Job Descriptor Entries (DJDEs) Xerox job restrictions Chapter 1. Introducing InfoPrint XT 5 6 Chapter 1. Introducing InfoPrint XT 7 Other restrictions 8 Double-byte character set (DBCS) support Supported and unsupported Xerox DJDE and PDL commands Page 10 Chapter 2. Installing and configuring InfoPrint XT Understanding software requirements Required operating system Required UNIX emulation tools http://www.microsoft.com Optional printer driver software 12 Installing InfoPrint XT Chapter 2. Installing and configuring InfoPrint XT 13 C:\Program Files\IBM\Infoprint XT C:\mypdxt\samples C:\Program Files\IBM\Infoprint XT\var\pdxt\resources\common Creating the InfoPrint XT configurable transform 14 Usage notes pdls -c transform servername : InfoPrint Manager returns information that is similar to this: Using the pdxtsetdest command to update InfoPrint Manager actual destinations Usage notes Streams used by the pdxtsetdest command Return codes from the pdxtsetdest command 16 Adding Windows user account names for InfoPrint Manager security Testing the InfoPrint XT installation Testing with the pdxtloadres and pdxtx2afp commands cd %PDXTINSTDIR%\testjob 3. Load the resources for the test job: Testing with InfoPrint Manager cd %PDXTINSTDIR%\testjob 3. Load the resources for the test job: pdxtloadres -n "*" -g pdxttest 4. Submit the test job: Applying an InfoPrint XT product update 18 Rejecting an InfoPrint XT product update Chapter 2. Installing and configuring InfoPrint XT 19 Permanently removing the InfoPrint XT software pddisable -c printer adestname pdset -c printer -x document-formats-supported-=lcds adestname 20 Chapter 3. Customizing InfoPrint XT Terms used in this chapter C:\Program Files\IBM\Infoprint XT C:\Program Files\IBM\Infoprint XT\var\pdxt Setting environment variables Controlling how InfoPrint XT interprets directory names (PDXT_WINPA TH2UNIX) Command PDXT_WINPATH2UNIX setting Resulting directory pdxtloadres -n "c:\ directory \*" 22 Table 3. DOS-to-UNIX directory conversions (continued) Command PDXT_WINPATH2UNIX setting Controlling the default arguments when you load resources (PDXTLOADRES_ARGS) -r -m A4 -s word -n C:\xyz\*.fnt v If the value contains a space, enclose the value in double quotation marks: Controlling resource-load messages for FILE DJDE jobs (PDXT_AIOLXDFE_TRACE) 24 Activating trace functions for the font converter (PDXT_XR2FAPI_TRACE) Activating trace functions for the image and logo converter (PDXT_XR2IAPI_TRACE) Controlling the content of error messages (PDXT_INTMSGIDS) Controlling the format of the error sheet (PDXT_MSG xxxxxxx ) Environment variables for directives Creating a custom parameter mapping file 26 destination-pass-through="-opa=jobname=pdxttest" destination-pass-through="-opa=class=D" Parameter mapping file syntax rules To specify all jobs with a destination of PRT, followed by any three characters: dest=PRT??? To specify all jobs with a class value of any single character from A through M : class=[A-M] Verifying the parameter specification of the mapping file 28 5016-501 2007-11-01 21:51:40 (pid 83951854) - transform started Figure 2. Completed parameter mapping file Using transform directives Chapter 3. Customizing InfoPrint XT 29 Transform directives and syntax Trace transform directives 30 -x xztrace=all1:all2 Activating transform directives -t x2afp.out -k1 Working with InfoPrint XT AFP structured fields InfoPrint XT NOP structured field format InfoPrint XT AIOX2AFP NOP level X'0000' format InfoPrint XT AIOX2AFP NOP keywords 32 The CTLHEADR record has no associated data. Chapter 3. Customizing InfoPrint XT 33 The data for the XRXCDJDE record is the comment text in EBCDIC. An XRXCDJDE record for comment text might contain: + End of Programming Interface information - + Working with content-sensitive medium map names Byte Bit Description 1 Not applicable InfoPrint XT always uses X'C6'. 2 through 5 Not applicable These bytes specify the bin number in hexadecimal format. Bins are numbered 1 through 4; bin 65 is the envelope bin, and bin 100 is the manual bin. 34 Chapter 3. Customizing InfoPrint XT 35 Page Chapter 4. Loading Xerox resources Copyright InfoPrint Solutions Company 2004, 2007 pdxtman pdxt_resources Transferring Xerox printer resources to the Windows system Understanding the load process for Xerox resources Types of Xerox resources that you can load 38 Xerox resource type and extension Resulting InfoPrint XT AFP prefixes Chapter 4. Loading Xerox resources 39 Not generated for double-byte character set fonts. Loading Xerox double-byte character set (DBCS) fonts Loading order for Xerox resources by resource type Information files generated by InfoPrint XT during resource tasks 40 2007-11-11 12:16:13 MST pdxtloadres -r -n *fnt 2007-11-11 12:16:17 MST pdxtloadres (16) 2007-11-11 15:23:28 MST pdxtloadres (0) Error information for resources that fail to load Chapter 4. Loading Xerox resources 41 Using the pdxtloadres command to load Xerox resources 42 Page 44 Chapter 4. Loading Xerox resources 45 Valid paper sizes are: 46 pdxtloadres -n "C:\My Fonts\*.fnt" v To load all resources in the current directory that begin with the letter a : pdxtloadres -n a* v To delete a specific JDL file in a specific group: pdxtloadres -f delete -g payroll -n dplonl.jdl Chapter 4. Loading Xerox resources 47 48 Streams used by the pdxtloadres command Chapter 4. Loading Xerox resources 49 fd2 (STDERR) The command writes messages to this stream. Return codes from the pdxtloadres command 50 + End of Programming Interface information - + Examples: pdxtloadres command pdxtloadres -l %PDXTWORKDIR%\resources\resource.list Printing samples of overlays and page segments Chapter 4. Loading Xerox resources 51 pdpr -d ldest %PDXTWORKDIR%\resources\printrun\SIBROM1 pdpr -d ldest .\SIBROM1 Correlating font, image, or logo resources manually Creating manual correlation entries for single-byte Xerox fonts F XName A2ETable CFont | CSet Cpage | PSeg {Char | XChar} [X=nn] [Y=nn] F ABC X2AFP S1ABCA A F ABC X2AFP S1ABC41 41 52 Creating manual correlation entries for double-byte Xerox fonts Chapter 4. Loading Xerox resources 53 D XName A2ETable CFont D CX24L X2AFP XZABCDEF Creating manual correlation entries for images Creating manual correlation entries for logos 54 L XName PSeg [X=nn] [Y=nn] correlation table for Xerox logos. Processing a manual correlation table Deblocking and reblocking CMDs, FSLs, ISLs, and JSLs Using the pdxtdblkres command to deblock resources Chapter 4. Loading Xerox resources 55 You can specify more than one file. Separate the file names with spaces. Streams used by the pdxtdblkres command Using the pdxtblkres command to block resources You can specify more than one file. Separate the file names with spaces. Chapter 4. Loading Xerox resources 57 Streams used by the pdxtblkres command Return codes from the pdxtblkres command Restrictions Page Chapter 5. Submitting Xerox jobs for data stream conversion Copyright InfoPrint Solutions Company 2004, 2007 pdxtman pdxt_jobs Processing Xerox jobs with InfoPrint Manager Document attributes that you specify for processing How InfoPrint XT searches for resources Using the pdpr command to transform and print Xerox jobs Using the pdxtx2afp command to process Xerox jobs Chapter 5. Submitting Xerox jobs for data stream conversion 61 62 -p passthru_values -p -opa=passthru_values -p -opa=class=D,forms=BILLING Chapter 5. Submitting Xerox jobs for data stream conversion 63 -p -opa=jobname=NOV004 Streams used by the pdxtx2afp command 64 Return codes from the pdxtx2afp command Chapter 5. Submitting Xerox jobs for data stream conversion 65 Examples: pdxtx2afp command Processing jobs that contain FILE DJDE commands Processing limitations Including resource-load messages for FILE DJDE jobs Processing jobs that contain stapling commands 66 Chapter 6. Transferring jobs with Download for z/OS Copyright InfoPrint Solutions Company 2004, 2007 pdxtman pdxt_download What the InfoPrint XT pdxtdownload program does Setting up Download for z/OS 68 Creating InfoPrint Manager MVS Download receivers Chapter 6. Transferring jobs with Download for z/OS 69 C:\Program Files\IBM\Infoprint XT\bin\pdxtdownload.exe Using JCL parameters to assign InfoPrint Manager attributes 70 FORMDEF -of Not applicable Not applicable -odatat Not applicable DCB=OPTCD=J -otrc Not applicable Creating an attribute mapping file keyword=value 72 Chapter 6. Transferring jobs with Download for z/OS 73 resource-context=C:\Program Files\IBM\Infoprint XT\var\pdxt\resources\BLUE Processing jobs that contain more than one data set Figure 7. Completed attribute mapping file Using download directives 74 Chapter 6. Transferring jobs with Download for z/OS 75 76 -p a2m=multi,addmcc=multi,addskip=multi Chapter 6. Transferring jobs with Download for z/OS 77 PRTQUEUE='IP4000 initial-value-document=dfault' For example, if the PRTQUEUE statement has this value: PRTQUEUE='room-text=B12-4 title-text=DRAFT' Enabling download directives 78 # Port 6001: # - Do not merge jobs with more than one dataset 6001: -m none # All ports: # - Do not prepend the job identifier to input file names *: -j no pdxtdownload file naming conventions Receiver log 80 Figure 8. Sample Download receiver log Temporary files -n copies_for_document_A -f document_A -n copies_for_document_B -f document_B Restrictions node-id-text room-text user-id-text Chapter 6. Transferring jobs with Download for z/OS 81 Page Chapter 7. Troubleshooting InfoPrint XT Problem determination: The job resulted in some type of printed output pdls -c job -r document-format ServerName_JobIdentifier Copyright InfoPrint Solutions Company 2004, 2007 pdpr -p ldest -x job-hold=true drive:\path\jobname Problem determination: The job resulted in no printed output 84 pdls -f "job-name= jobname " pdenable -c destination adestname 51 skye_289100001 jobname held 1 skye-ld Note: If you do not know the name of the job, you can enter the command: pdls | more pdls 51 InfoPrint Manager returns information that is similar to this: pdls -r job-state-reasons 51 86 Problem determination: Processing jobs through Download for z/OS Chapter 7. Troubleshooting InfoPrint XT 87 88 Diagnostic and informational files that InfoPrint XT produces pdxtx2afp.log file 5016-501 2007-11-11 14:46:26 MDT (pid 621) - transform started 5016-505 Transform directives (pdxtx2afp -t): 2 5016-506 -k = "1" 5016-511 Return codes: 4 5016-512 1) 0 (pid -1) x2afp.lst file 90 5016-521 x2afp.lst this keyword are: Service coordinator responsibilities Chapter 7. Troubleshooting InfoPrint XT 91 Determining problem severity Placing a service call Determining the version of InfoPrint XT Using the pdxtcapture command Using the pdxtclnwork command to clean work directories 92 Appendix A. Conversion parameters for converting Xerox jobs -x "other-transform-options=' parm=value parm=value parm=value '" Copyright InfoPrint Solutions Company 2004, 2007 94 Appendix A. Conversion parameters for converting Xerox jobs 95 96 Appendix A. Conversion parameters for converting Xerox jobs 97 98 Appendix A. Conversion parameters for converting Xerox jobs 99 100 Page 102 Appendix A. Conversion parameters for converting Xerox jobs 103 Page Appendix B. InfoPrint XT messages: 5016-nnn Copyright InfoPrint Solutions Company 2004, 2007 106 Appendix B. InfoPrint XT messages: 5016-nnn 107 108 Appendix B. InfoPrint XT messages: 5016-nnn 109 110 Appendix B. InfoPrint XT messages: 5016-nnn 111 112 Appendix B. InfoPrint XT messages: 5016-nnn 113 Return code numbers 114 Appendix B. InfoPrint XT messages: 5016-nnn 115 Page Appendix C. Resource converter messages: 5018-nnn Copyright InfoPrint Solutions Company 2004, 2007 117 118 Appendix C. Resource converter messages: 5018-nnn 119 120 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx Copyright InfoPrint Solutions Company 2004, 2007 Resource path names used in messages InfoPrint XT resource utility messages option 122 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 123 124 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 125 126 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 127 128 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 129 130 .fnt name AFP name(s) line spacing value fnt_name AFP_name AFP_name x inches or y pels x inches or y pels .fnt name Page segment name(s) Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 131 InfoPrint XT data stream converter messages AIOxxx000S Unrecognized keyword: keyword . Valid keywords are: keyword: 132 option Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 133 134 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 135 136 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 137 138 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 139 140 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 141 142 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 143 144 Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx 145 Page Appendix E. DJDE report messages: ALTER through XMP Copyright InfoPrint Solutions Company 2004, 2007 148 .fnt name AFP name(s) line spacing value fnt_name afp_name afp_name x inches or y pels x inches or y pels .fnt name AFP name(s) line spacing value fnt_name afp_name afp_name x inches or y pels x inches or y pels .fnt name AFP name(s) line spacing value fnt_name afp_name afp_name x inches or y pels x inches or y pels Appendix E. DJDE report messages: ALTER through XMP 149 150 Appendix E. DJDE report messages: ALTER through XMP 151 Report copy line no. column no. Xerox font name AFP name(s) copy_num copy_num line_num line_num 152 Command Stock Reference Cluster Name Appendix E. DJDE report messages: ALTER through XMP 153 154 Notices Copyright InfoPrint Solutions Company 2004, 2007 Programming interfaces 156 Trademarks Notices 157 Page Glossary of selected InfoPrint Solutions Company terms A C Copyright InfoPrint Solutions Company 2004, 2007 160 G I J L Glossary of selected InfoPrint Solutions Company terms 161 162 Glossary of selected InfoPrint Solutions Company terms 163 S T W X Z Glossary of selected InfoPrint Solutions Company terms 165 Page Glossary of selected Xerox terms C Copyright InfoPrint Solutions Company 2004, 2007 D E F G H I J L Glossary of selected Xerox terms 169 170 Bibliography Copyright InfoPrint Solutions Company 2004, 2007 v Print Services Facility for z/OS: Download for z/OS, S544-5624 http://www.infoprint.com For online access and ordering for IBM publications, go to: InfoPrint Solutions Company printers 172 Index Special characters Numerics A B 174 Page H 176 Page 178 Page U V 180 W Y