Ricoh INFOPRINT XT GLD0-0025-01 Installation And User Manual
Ricoh INFOPRINT XT GLD0-0025-01 Installation And User Manual

Ricoh INFOPRINT XT GLD0-0025-01 Installation And User Manual

For windows
Table of Contents

Advertisement

Quick Links

InfoPrint XT for Windows:
Installation Guide and User's Guide
V ersion 2 Release 1
GLD0-0025-01

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the INFOPRINT XT GLD0-0025-01 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Ricoh INFOPRINT XT GLD0-0025-01

  • Page 1 InfoPrint XT for Windows: Installation Guide and User’s Guide V ersion 2 Release 1 GLD0-0025-01...
  • Page 3 InfoPrint XT for Windows: Installation Guide and User’s Guide V ersion 2 Release 1 GLD0-0025-01...
  • Page 4 Note: Before using this information and the product it supports, read the information in “Notices” on page 155. Second edition (Devember 2007) This edition applies to the InfoPrint XT for Windows programming request for price quotation (PRPQ), 5799-RZA, Version 2.1.0.110 (Product Update 11) and to all subsequent releases and modifications until otherwise indicated in new editions.
  • Page 5: Table Of Contents

    Contents Figures ....vii Tables ....ix About this publication ..xi Who should use this publication How this publication is organized .
  • Page 6 Loading order for Xerox resources by resource type . Information files generated by InfoPrint XT during resource tasks . Error information for resources that fail to load Using the pdxtloadres command to load Xerox resources . Streams used by the pdxtloadres command . Return codes from the pdxtloadres command .
  • Page 7 InfoPrint Solutions Company printers . . 172 Index ....173 Contents...
  • Page 8 InfoPrint XT Guide...
  • Page 9: Figures

    Figures InfoPrint XT test page . Completed parameter mapping file Sample correlation entries for single-byte Xerox fonts . Sample correlation entries for Xerox images © Copyright InfoPrint Solutions Company 2004, 2007 . 18 Sample correlation entries for Xerox logos . 28 Sample z/OS routing-control data set .
  • Page 10 viii InfoPrint XT Guide...
  • Page 11: Tables

    Tables Printable Xerox resources and their AFP functional equivalents . Supported and unsupported PDL and DJDE commands . DOS-to-UNIX directory conversions . Format of the transform parameter mapping file InfoPrint XT NOP structured field format InfoPrint XT NOP level X'0000' format Format of content-sensitive medium map names .
  • Page 12 InfoPrint XT Guide...
  • Page 13: About This Publication

    About this publication This publication describes how to install, configure, and use InfoPrint Windows (InfoPrint XT). With InfoPrint XT, you can process and print Xerox Line Conditioned Data Stream (LCDS) jobs and Xerox metacode jobs on Intelligent Printer Data Stream You can use InfoPrint XT with InfoPrint Manager for Windows (InfoPrint Manager) or as a stand-alone transform.
  • Page 14: Conventions Used In This Publication

    Chapter 6, “Transferring jobs with Download for z/OS,” on page 67 Describes how to set up Download for z/OS to work with InfoPrint XT. After you set this up, you can submit jobs from systems that have IBM Print Services Facility (PSF) for z/OS installed and convert them with InfoPrint XT.
  • Page 15: Understanding The Syntax Notation And The Use Of Special Characters

    InfoPrint XT, certain procedures also instruct you to enter InfoPrint Manager commands, such as pdls and pdpr. Enter these commands from a Windows Command Prompt window; InfoPrint XT does not provide a user interface. Related information Other sources of information that you can use with InfoPrint XT are:...
  • Page 16: Infoprint Xt Manual (Man) Pages

    InfoPrint XT manual (man) pages An InfoPrint XT installation includes online help in the form of man pages. To see the InfoPrint XT man pages, enter the pdxtman command, followed by the name of the man page. For example: pdxtman pdxt For a complete list of all the man pages that InfoPrint XT supplies, access the pdxt man page.
  • Page 17: Summary Of Changes

    Summary of changes These are brief descriptions of the functional updates to InfoPrint XT for Windows (InfoPrint XT) and the corresponding documentation changes that this publication contains: Support for content-sensitive medium maps The InfoPrint XT data stream converter uses a sequentially numbered naming convention for medium map names in the inline form definition that it generates as it converts a Xerox job.
  • Page 18 the job to further verify the type of carriage controls. If it detects a different type of carriage control, InfoPrint XT overrides the type that the xcc parameter specifies. With Download for z/OS, InfoPrint XT can use a download directive to convert ANSI carriage controls to machine code before it converts the job.
  • Page 19 v The -b option for the pdxtloadres command on page 42 v The xspcrmi conversion parameter on page 101 Enhancements to Xerox shading support The InfoPrint XT default is to convert Xerox shading patterns to raster dot patterns in the AFP output. InfoPrint XT also converts shading characters in Xerox FRMs to raster dot patterns in the corresponding AFP overlays.
  • Page 20 For information about the xhonorshift conversion parameter, see page 96. Generation of NOP structured fields for C DJDE text Mixed Object Document Content Architecture (MO:DCA) No Operation (NOP) structured fields can store information in the AFP data stream. In addition to NOPs for OTEXT, AFP fonts and page segments, and highlight color, you can now instruct InfoPrint XT to generate NOPs for comments that C DJDEs contain.
  • Page 21: Chapter 1. Introducing Infoprint Xt

    Chapter 1. Introducing InfoPrint XT This chapter briefly describes the components of InfoPrint XT for Windows (InfoPrint XT), how it processes jobs, and its non-supported or restricted functions. InfoPrint XT is the Xerox transform technology that you can use to print Xerox jobs on high-speed, Intelligent Printer Data Stream (IPDS) printers.
  • Page 22: Printable Xerox Resources

    XT load process. The InfoPrint XT pdxtloadres command does the actual conversion. You also convert the non-printable resources. Printable Xerox resources Xerox jobs use specific printable Xerox resources, such as fonts, forms, images, and logos. Table 1 lists the major types of printable Xerox resources and their equivalent AFP resources.
  • Page 23: Non-Printable Xerox Resources That Infoprint Xt Does Not Use

    v “InfoPrint XT resource utility messages” on page 121 Non-printable Xerox resources that InfoPrint XT does not use The other types of non-printable Xerox resources that you can load through InfoPrint XT are: v CMD v DAT v FSL v ICT v IDR v ISL v JSL...
  • Page 24: Methods Of Sending Jobs To The Windows System And Submitting Them To Infoprint Xt

    Methods of sending jobs to the Windows system and submitting them to InfoPrint XT You can use these methods to send Xerox LCDS and metacode jobs to the Windows system and to process them with InfoPrint XT: Download for z/OS Download for z/OS is a separately orderable, licensed feature of IBM Print Services Facility (PSF) for z/OS.
  • Page 25 Grayscale substitution for Xerox shading Highlight-color form processing Highlight-color image processing InfoPrint XT can interpret and convert Xerox shading patterns and characters to grayscale. This improves the overall visual results and increases the readability for any text that is superimposed on the shading. These restrictions apply to grayscale substitution when you use the xshading conversion parameter or the -c option of the pdxtloadres command:...
  • Page 26 Highlight-color job processing OTEXT messages SHIFT and XSHIFT JDL and DJDE commands Spacing characters in Xerox fonts InfoPrint XT Guide You can submit Xerox jobs that contain color-related metacodes or PDL commands, such as ICATALOG, IDR, ILIST, and INKINDEX. However, InfoPrint XT does nothing with the color information.
  • Page 27 Stapling support code points. This function does not correct any other type of code page conflicts that occur after manually correlating Xerox resources to AFP resources. When you submit jobs that request stapling, these restrictions apply to InfoPrint XT processing: v You must specify the xhonorstaple=yes conversion parameter for InfoPrint XT to process jobs that contain stapling instructions.
  • Page 28: Other Restrictions

    Note: For more information about the xhonorstaple, xstapleorient, Other restrictions These InfoPrint XT restrictions apply to considerations other than Xerox job conversion: 240-pel resolution support InfoPrint XT only supports 300-pel resolution. If you have older printer models that support 240-pel resolution, do not direct jobs from InfoPrint XT to them.
  • Page 29 Table 2. Supported and unsupported PDL and DJDE commands (continued) BFORM CANCEL COLLATE COPIES DATA DEPT DUPLEX FACEUP ³ FEED FILE FONTINDEX FONTS FORMAT FORMS GRAPHIC IMAGE INVERT MARGIN MODIFY NTO1 ³ NUMBER OTEXT ⁴ OVERPRINT PMODE RFORM RTEXT SHIFT ⁴ SIDE STAPLE STOCKS...
  • Page 30 v ¹ InfoPrint XT ignores these commands when it finds them in a job. InfoPrint XT processes the job and issues informational messages that state that it ignored the commands. v ² This is a CME parameter. v ³ InfoPrint XT only supports this command when you use it with the STAPLE command.
  • Page 31: Chapter 2. Installing And Configuring Infoprint Xt

    Chapter 2. Installing and configuring InfoPrint XT This chapter describes how to install software, configure a base InfoPrint XT for Windows (InfoPrint XT) system, and test the installation. Understanding software requirements Before you install InfoPrint XT you must first install other required software products and their prerequisites.
  • Page 32: Optional Printer Driver Software

    You can select Standard Installation when you install SFU. Also, consider enabling setuid behavior and case-sensitivity during installation. Setuid behavior controls aspects of security and user privileges. Case-sensitivity changes the normal case-insensitivity of the Windows environment. The Microsoft Web site contains detailed information about these topics.
  • Page 33: Installing Infoprint Xt

    4. Read the installation readme file on the CD for any last-minute updates that are not available in this publication. 5. Click Next on the Welcome window to display the License Agreement. You must accept the terms of the License Agreement to continue with installation.
  • Page 34: Creating The Infoprint Xt Configurable Transform

    Creating the InfoPrint XT configurable transform Use the pdxtcrtxform command to create an InfoPrint XT configurable transform object in the InfoPrint Manager server. This command creates the transform object with the name x2afp and sets the transform attributes that InfoPrint XT requires. For example, it sets the lcds and metacode values for the document-formats- supported attribute.
  • Page 35: Using The Pdxtsetdest Command To Update Infoprint Manager Actual Destinations

    ETIMEDOUT The pdls command did not respond to a query. other Any other return codes that are not in this list are return codes from C functions. See “Return code numbers” on page 113 for explanations. + — — — — — – — End of Programming Interface information — — — — — - — + Using the pdxtsetdest command to update InfoPrint Manager actual destinations Use the pdxtsetdest command to set up an InfoPrint Manager actual destination to...
  • Page 36: Adding Windows User Account Names For Infoprint Manager Security

    To test the InfoPrint XT installation: 1. Access a Windows Command Prompt window. 2. Make the directory that contains the test job the current directory. From the command line, enter: cd %PDXTINSTDIR%\testjob 3.
  • Page 37: Testing With Infoprint Manager

    InfoPrint XT installation in a combined InfoPrint Manager and InfoPrint XT environment. To test the InfoPrint Manager and InfoPrint XT installation: 1. Access a Windows Command Prompt window. 2. Make the directory that contains the test job the current directory. From the command line, enter: cd %PDXTINSTDIR%\testjob 3.
  • Page 38: Applying An Infoprint Xt Product Update

    InfoPrint XT InfoPrint XT Figure 1. InfoPrint XT test page Applying an InfoPrint XT product update When an InfoPrint XT update is available, you can install it on the system to run the latest level of InfoPrint XT. The update can be on a CD that you receive, or you can download updates from this Web site: ftp://ftp.software.ibm.com/printers/products/pdxt/fixes Notes:...
  • Page 39: Rejecting An Infoprint Xt Product Update

    1. Close any applications that you are running on the Windows system. 2. Log on to the system with a Windows computer administrator account. 3. Open a Windows Command Prompt window. 4. Do this step only if you use InfoPrint Manager with InfoPrint XT. Otherwise, continue with the next step: a.
  • Page 40 b. Select and delete the InfoPrint XT %PDXTWORKDIR% working directory. The default working directory is C:\Program Files\IBM\Infoprint XT\var\pdxt. c. Select and delete the InfoPrint XT %PDXTINSTDIR% installation directory. The default installation directory is C:\Program Files\IBM\Infoprint XT. 7. Restart the Windows system. InfoPrint XT Guide...
  • Page 41: Chapter 3. Customizing Infoprint Xt

    Chapter 3. Customizing InfoPrint XT This chapter describes how to customize InfoPrint XT for Windows (InfoPrint XT). All procedures in this chapter are optional; you do not have to do them to use InfoPrint XT. Terms used in this chapter Some topics in this chapter use the term ServerName_JobIdentifier.
  • Page 42: Controlling The Working Directory That Infoprint Xt Uses For Variable Data (Pdxtworkdir)

    Controlling the working directory that InfoPrint XT uses for variable data (PDXTWORKDIR) The PDXTWORKDIR environment variable controls the working directory that InfoPrint XT uses for variable data. The default is that InfoPrint XT uses subdirectories in the %PDXTWORKDIR% directory to store the files that it creates or copies for Xerox resources and jobs.
  • Page 43: Controlling The Default Arguments When You Load Resources (Pdxtloadres_Args)

    Table 3. DOS-to-UNIX directory conversions (continued) Command pdxtloadres -n "/directory/*" pdxtloadres -n "/directory/*" v ¹ InfoPrint XT always treats this as a DOS directory, regardless of the PDXT_WINPATH2UNIX setting, because it contains backslashes. v ² The conversion process derives the drive letter from the drive in use when you entered the command.
  • Page 44: Controlling Resource-Load Messages For File Djde Jobs (Pdxt_Aiolxdfe_Trace)

    These are examples of values that you can enter in the Variable value field of the Windows System Properties interface: v To specify a single option and value: -g payroll v To specify the -x option with more than one value, use double quotation marks: -x "xjdl=tonl xjde=dflt xclb=pay"...
  • Page 45: Controlling The Format Of The Error Sheet (Pdxt_Msgxxxxxxx)

    also writes a line number from the module, which indicates the line at which the condition that caused the message occurred. The expanded output is similar to this: pdxtclnwork: (aioxcwrk0139) 5016-001 The command option -o is not valid. This message shows that the error resulted from a pdxtclnwork command and that the error occurred at line 0139 of the module aioxcwrk.
  • Page 46: Creating A Custom Parameter Mapping File

    Creating a custom parameter mapping file When you convert a Xerox job, you must specify certain parameters that equate to the Xerox START command for the job. The parameters include the starting Job Descriptor Library (JDL) and Job Descriptor Entry (JDE) pair. You might also specify other parameters that further define the job, such as how to process stapling commands.
  • Page 47 The parameters that you can assign are -g, -r, -t, and -x. These parameters correspond to a subset of the processing parameters that you can specify with the pdxtx2afp command. These rules apply to the parameter mapping file: v You must use lowercase keyword names in the mapping file: class, dest, forms, jobid, or jobname.
  • Page 48: Verifying The Parameter Specification Of The Mapping File

    #-----------------------------------------------------# # Set the default for all jobs that do not match any # # other criteria #-----------------------------------------------------# -x"xjde=base xjdl=base1" #-----------------------------------------------------# # Set parameters for FORMS=STD and CLASS=K jobs #-----------------------------------------------------# forms=STD class=K -x"xjde=std xjdl=dpljdl" #-----------------------------------------------------# # Set parameters for FORMS=RED or CLASS=J jobs #-----------------------------------------------------# forms=RED class=J...
  • Page 49: Using Transform Directives

    Using transform directives InfoPrint XT provides a set of internal directives that you can activate to control certain aspects of the overall data stream conversion process. For example, you can instruct InfoPrint XT to capture traces of the job data stream as it flows through the conversion process.
  • Page 50: Trace Transform Directives

    [-x "conversion_parameters"] Specifies conversion parameters. Any parameters that you specify with this directive override the same parameters if you specify them with other methods. For example, if you specify them with the -x option of the pdxtx2afp command or if you specify them with the other-transform- options attribute in the InfoPrint Manager environment.
  • Page 51: Working With Infoprint Xt Afp Structured Fields

    #------------------------------------------------# # Capture and keep the Xexox input and the AFP # output for all jobs with a destination of # PRT01. #------------------------------------------------# PRT01: '-t "x2afp.in x2afp.out"' -k1 -t command option of the pdxtx2afp command If you enter the pdxtx2afp command directly to convert a Xerox job, you can specify directives using the -t command option.
  • Page 52: Infoprint Xt Aiox2Afp Nop Level X'0000' Format

    Table 5. InfoPrint XT NOP structured field format (continued) Offset 19-n InfoPrint XT AIOX2AFP NOP level X'0000' format Table 6 shows the format of the InfoPrint XT AIOX2AFP level X'0000' NOP, which consists of four parts. Table 6. InfoPrint XT NOP level X'0000' format Offset 30-n InfoPrint XT AIOX2AFP NOP keywords...
  • Page 53 XRXOTEXT (X'E7D9E7D6E3C5E7E3') AFPRLEVL (X'C1C6D7D9D3C5E5D3') XRXHCINK (X'E7D9E7C8C3C9D5D2') XRXCDJDE (X'E7D9E7C3C4D1C4C5') Bit 7: Reserved for future use. The CTLHEADR record has no associated data. A CTLHEADR record that indicates the possible presence of NOPs generated from OTEXT DJDEs might contain: ----+----1----+----2----+----3 !..LÓÓ...AIOX2AFP..CTLHEADR... 501DEE000CCDEFCCD00CEDCCCCD800 A0D3EE000196721670033385149000 A CTLHEADR record that indicates the possible presence of NOPs generated from C DJDEs might contain:...
  • Page 54: Working With Content-Sensitive Medium Map Names

    + — — — — — – — End of Programming Interface information — — — — — - — + Working with content-sensitive medium map names InfoPrint XT creates an AFP form definition for each Xerox job that it processes. It embeds the form definition in the AFP data stream that it generates from the Xerox data stream.
  • Page 55 ² Bins are numbered 1 through 255. For information about the xcsmmname conversion parameter, see page 96. Chapter 3. Customizing InfoPrint XT...
  • Page 56 InfoPrint XT Guide...
  • Page 57: Chapter 4. Loading Xerox Resources

    Chapter 4. Loading Xerox resources This chapter describes how to use InfoPrint XT for Windows (InfoPrint XT) to load the Xerox resources. Load all the Xerox resources before you begin to process jobs with InfoPrint XT. For an overview about working with Xerox resources, see the pdxt_resources man page that InfoPrint XT provides.
  • Page 58: Types Of Xerox Resources That You Can Load

    v %PDXTWORKDIR%\resources\common\metrics v %PDXTWORKDIR%\resources\resgrp\metrics v C:\OtherDirectory\metrics Xerox resource directory For all resources that successfully load, InfoPrint XT copies the original Xerox resource to the system. The directory in which InfoPrint XT writes the Xerox resources depends on the load options. The Xerox resource directory is one of these: v %PDXTWORKDIR%\resources\common\xrxres v %PDXTWORKDIR%\resources\resgrp\xrxres...
  • Page 59: Loading Xerox Double-Byte Character Set (Dbcs) Fonts

    Table 8. Xerox resource extensions, AFP prefixes, and metrics extensions (continued) Xerox resource type and extension Job Source Library - .jsl Logo - .lgo Miscellaneous - .msc Page Descriptor Entry - .pde Patch - .pch Stockset - .stk Routing Text - .tst Temporary - .tmp ¹...
  • Page 60: Information Files Generated By Infoprint Xt During Resource Tasks

    Information files generated by InfoPrint XT during resource tasks InfoPrint XT creates files in which it stores information about resource tasks, such as loading and deleting resources. The next topics describe the various files using the common resource group and its AFP resource directory. If you load the resources in a different directory, substitute that AFP resource directory name: %PDXTWORKDIR%\resources\common\pdxtloadres.log This file contains information about each time the pdxtloadres command...
  • Page 61: Error Information For Resources That Fail To Load

    but do not enter a value for that option. This causes InfoPrint XT to use the information in the pdxtloadres.rty file to determine the resources to load. Note: InfoPrint XT overwrites the information in the pdxtloadres.rty file with each time the pdxtloadres command runs. Error information for resources that fail to load InfoPrint XT also stores information about the individual resources that fail in the working directory that it uses during the resource load process.
  • Page 62: Using The Pdxtloadres Command To Load Xerox Resources

    Using the pdxtloadres command to load Xerox resources You use the InfoPrint XT pdxtloadres command to load all the Xerox resources on the Windows system and to create the AFP versions of printable resources. The command provides options that you can use to control how and where InfoPrint XT creates the converted resource files.
  • Page 63 [-c xerox | grayscale | [lp]:[mp]:[hp]] Presentation Text Object Content Architecture (PTOCA) text-string characters. This is the default. spcrmi InfoPrint XT interprets spacing characters in the font as Relative Move Inline (RMI) structured fields. Application programs that issue the pdxtloadres command can use these universal values instead of the language-specific keywords: v API:SPCPRT is the same as spcprt.
  • Page 64 [-e listings | nolistings] [-f load | delete] InfoPrint XT Guide any position, InfoPrint XT uses the default percentage for LIGHT, MEDIUM, or HEAVY. These are examples of values you can specify: -c :8:16 InfoPrint XT uses 5% coverage for LIGHT shading, 8% for MEDIUM, and 16% for HEAVY.
  • Page 65 [-g common | resgrp] [-i] [-l listfile] Application programs that issue the pdxtloadres command can use these universal values instead of the language-specific keywords: v API:LOAD is the same as load. v API:DELETE is the same as delete. Note: If the AFP resource directory contains DBCS fonts, InfoPrint XT does not delete them when it deletes the Xerox DBCS font resources.
  • Page 66 [-m letter | medium] [-M none | all | xerox | xerox+font1:font2:fontn | xerox-font1:font2:fontn | font1:font2:fontn] InfoPrint XT Guide 2. If you are loading resources, you can specify Xerox resources with names that follow IBM Infoprint XT Extender for z/OS naming conventions.
  • Page 67 | | | [-n pattern] v CMC7 For example, InfoPrint XT generates AFP MICR fonts for these Xerox fonts: E13BPX.FNT, E14BL.FNT, CMC7J.FNT. xerox+font1:font2:fontn InfoPrint XT generates AFP MICR fonts for all Xerox fonts whose names begin with E13B, E14B, or CMC7. In addition, it generates AFP MICR fonts for up to 33 fonts that you specify by name.
  • Page 68: Ibm Infoprint Xt Extender For Z/Os Naming

    [-o OtherDirectory] InfoPrint XT Guide Notes: 1. If you use both the -n option and the -i option, do not include path information in the value for the -n option. 2. When you delete resources, you must specify resource names in lowercase.
  • Page 69: Streams Used By The Pdxtloadres Command

    [-p 300_1 | 300_2] [-r] [-s none | word | char] Streams used by the pdxtloadres command The pdxtloadres command uses some file descriptors while it processes Xerox resources and ignores others: fd0 (STDIN) fd1 (STDOUT) If you specify the -o option, you cannot specify the -g option. If you do not specify either -o or -g, the pdxtloadres command uses the common resource group.
  • Page 70: Return Codes From The Pdxtloadres Command

    fd2 (STDERR) Return codes from the pdxtloadres command Return codes from the pdxtloadres command mean: EINVAL E2BIG ENOATTR ENOENT ENOMEM EEXIST ECONNABORTED ECONNRESET other + — — — — — – — End of Programming Interface information — — — — — - — + Examples: pdxtloadres command These examples show how you can use the pdxtloadres command to load Xerox resources:...
  • Page 71: Printing Samples Of Overlays And Page Segments

    You can use the pdxtx2afp command to create a preliminary list of the resources that a job requires. Before you scan the job, you must load the starting JDL for the job. When you scan the job, use the xafprc=12 and xconvert=no conversion parameters.
  • Page 72: Creating Manual Correlation Entries For Single-Byte Xerox Fonts

    not have to start at the same column location as the second keyword of another entry. You might want to use a specific columnar format, for readability, as you make entries. After you create the manual correlation tables, use the pdxtloadres command to apply the updates.
  • Page 73: Creating Manual Correlation Entries For Double-Byte Xerox Fonts

    Figure 3 shows the various types of entries that you can make in a manual font correlation table for single-byte Xerox fonts. F CRC12P X2AFP X0P0612C F RK141P X2AFP C0UN411E T1UN411E F CSFL30 X2AFP S1L3021 41 F CSFP01 X2AFP S1P0121 A F CSFP02 X2AFP S1P0122 21 Y=-7 F CSFP03 X2AFP S1P0123 F X=3 F CSFP04 X2AFP S1P0124 Y X=-3 Y=4...
  • Page 74: Creating Manual Correlation Entries For Logos

    at it in the portrait orientation. You can use X=nn to make a horizontal adjustment. nn is a value in pels. A positive value moves the page segment to the right. A negative value moves it to the left. Use Y=nn to make a vertical adjustment.
  • Page 75: Deblocking And Reblocking Cmds, Fsls, Isls, And Jsls

    table that is in the C:\Program Files\IBM\Infoprint Manager\reslib directory. If you loaded the Xerox resources in the common resource group, the copy command is similar to this: copy C:\Program Files\IBM\Infoprint Manager\reslib\X0423002 %PDXTWORKDIR%\resources\common Note: You can also use Windows Explorer to copy the file. 2.
  • Page 76: Using The Pdxtblkres Command To Block Resources

    replaces the contents of the existing file with the deblocked output. If you do not specify a file name, the command reads from standard input and writes to standard output. You can specify more than one file. Separate the file names with spaces. Streams used by the pdxtdblkres command The pdxtdblkres command uses file descriptors while it processes Xerox resources: fd0 (STDIN)
  • Page 77 v If you use standard input to pass the Xerox resource, the command uses the default name dfault.jsl. Note: The pdxtblkres command does not verify that the Xerox resource is a JSL. If you use the -f command option, you can only block one resource at a time.
  • Page 78 InfoPrint XT Guide...
  • Page 79: Chapter 5. Submitting Xerox Jobs For Data Stream Conversion

    Chapter 5. Submitting Xerox jobs for data stream conversion This chapter describes how to convert Xerox Line Conditioned Data Stream (LCDS) and metacode jobs to the Advanced Function Presentation (AFP) format. For a brief overview about working with Xerox jobs, see the pdxt_jobs man page that InfoPrint XT for Windows (InfoPrint XT) provides.
  • Page 80: How Infoprint Xt Searches For Resources

    command specifies, or the path to the resource group that the -g option specifies. See “Using the pdxtloadres command to load Xerox resources” on page 42. If you use a parameter mapping file, how you set up the mapping file entries determines which of these document attributes you must specify for Xerox jobs: document-format You must always specify lcds or metacode for this attribute.
  • Page 81: Using The Pdpr Command To Transform And Print Xerox Jobs

    creates AFP versions of the Xerox resources. When you submit a Xerox job, those AFP versions of the Xerox resources must be available to InfoPrint XT. This lists the locations in the order that InfoPrint XT searches them for the resources: 1.
  • Page 82 The syntax of the pdxtx2afp command is: pdxtx2afp [-i inputfile | -] [-o outputfile | -] [-i inputfile | -] [-o outputfile | -] [-g common | group] [-x "xjdl=dfault xjde=dflt" | "cparms"] [-p passthru_values] InfoPrint XT Guide [[-g common | group ]|[-r resourcepath]] [-x "xjdl=dfault xjde=dflt"...
  • Page 83 class=n Specifies the class for the job. This corresponds to the CLASS parameter that you specify if you submit the job with job control language (JCL). n is a single character. destination=dest Specifies the destination for the job. This corresponds to the DEST parameter that you specify if you submit the job with JCL.
  • Page 84: Streams Used By The Pdxtx2Afp Command

    Streams used by the pdxtx2afp command The pdxtx2afp command uses file descriptors while it processes Xerox jobs: fd0 (STDIN) fd1 (STDOUT) fd2 (STDERR) Return codes from the pdxtx2afp command Return codes from the pdxtx2afp command have these meanings: EINVAL E2BIG ENOATTR ECONNABORTED ECONNRESET...
  • Page 85: Examples: Pdxtx2Afp Command

    other + — — — — — – — End of Programming Interface information — — — — — - — + Examples: pdxtx2afp command These are examples of pdxtx2afp commands for conversion and scanning tasks: v In this example, the Xerox job and all files that the pdxtx2afp command generates are in the C:\Inputdata\Jobs\51230 directory.
  • Page 86: Processing Limitations

    There might be occasions when you want to embed some or all the permanent resources inline with the AFP data stream for the job. InfoPrint XT provides the xinlr conversion parameter, which you can use to specify which permanent resources you want InfoPrint XT to embed. You can specify one or more types of printable resources, such as AFP page segments and AFP character sets.
  • Page 87: Chapter 6. Transferring Jobs With Download For Z/Os

    Chapter 6. Transferring jobs with Download for z/OS This chapter describes how to set up and use Download for z/OS to submit Xerox jobs for processing by InfoPrint XT for Windows (InfoPrint XT). Download for z/OS is a communications mechanism that sends jobs to InfoPrint Manager for Windows (InfoPrint Manager).
  • Page 88: Setting Up Download For Z/Os

    externally. For example, you can use an attribute mapping file to set the attributes based on the characteristics of the job. See “Using JCL parameters to assign InfoPrint Manager attributes” on page 70 and “Creating an attribute mapping file” on page 71. 3.
  • Page 89: Creating Infoprint Manager Mvs Download Receivers

    Creating InfoPrint Manager MVS Download receivers When you create an InfoPrint Manager MVS Download receiver through the InfoPrint Manager Management Console, you specify pdxtdownload as the exit program name. This causes the receiver to call pdxtdownload for each job that it receives.
  • Page 90: Using Jcl Parameters To Assign Infoprint Manager Attributes

    Using JCL parameters to assign InfoPrint Manager attributes When an MVS Download receiver receives a data set and calls the pdxtdownload program, it passes a series of options and values. Some of the values, such as the job title, come from the job control language (JCL) statements that submitted the data set.
  • Page 91: Creating An Attribute Mapping File

    Table 10. InfoPrint Manager attribute assignments when using the pdxtdownload program (continued) Node ID OFFSETXB OFFSETXF OFFSETYB OFFSETYF OUTBIN OVERLAYB OVERLAYF PAGEDEF PRMODE Programmer PRTQUEUE RESFMT ROOM SEGMENT Source File TITLE User ID Notes: 1. These apply to AFP (MO:DCA-P) data sets. They do not apply to Xerox jobs. 2.
  • Page 92 a job matches the criteria, InfoPrint XT assigns the attribute-and-value pairs that follow the expression to the job. When you edit an attribute mapping file, make sure that the expressions start in the first column of the file. Precede attribute-and-value pairs by one or more blank spaces. Put each attribute-and-value pair on a separate line.
  • Page 93: Processing Jobs That Contain More Than One Data Set

    #-----------------------------------------------# # All jobs contain Xerox data streams #-----------------------------------------------# document-format=metacode #-----------------------------------------------# # Send all jobs from userid SMITH to logical # destination smith and limit them to 10 pages # #-----------------------------------------------# -ous=SMITH destination-name-requested=smith page-select=:10 #-----------------------------------------------# # Class D jobs, class E jobs, and any jobs with # # names that start with INV use resources from # # %PDXTWORKDIR%\resources\inventory #-----------------------------------------------#...
  • Page 94: Using Download Directives

    v You must install Print Parameters Exit 15 on z/OS. This causes the output writer to include sequence information with the data sets as it sends them. You can use either APSUX15 or APSUC15. PSF for z/OS provides these exits. v On the Windows system, make sure that you disable parallel processing when you create the InfoPrint Manager MVS Download receiver.
  • Page 95 nosubmit Does not submit jobs to InfoPrint Manager. Note: Use this download directive only at the direction of a technical support representative. Controls whether pdxtdownload adds the z/OS job identifier as a prefix to the input file name before it submits the job to InfoPrint Manager: pdxtdownload adds the z/OS job identifier to the input file name.
  • Page 96 none Note: pdxtdownload always processes jobs that contain a single data set Specifies how pdxtdownload pre-processes data sets as it receives them. For Xerox LCDS and metacode jobs, you might need to pre-process the data sets before InfoPrint XT can process them. For example, if you merge multi-dataset jobs together as a single job, make sure that all data sets use the same type of carriage control.
  • Page 97 addskip=none pdxtdownload does not add skip-to-channel-one carriage controls. This is the default. addskip=multi pdxtdownload adds skip-to-channel-one carriage controls to multi-dataset jobs. addskip=all pdxtdownload adds skip-to-channel-one carriage controls to all jobs. Note: pdxtdownload adds skip-to-channel-one carriage controls only to data sets that you process with the a2m and addmcc operands.
  • Page 98: Enabling Download Directives

    attr ignore pdxtdownload ignores the PRTQUEUE value. Enabling download directives You can enable download directives using one or both of these methods: PDXTDOWNLOAD_DIRECTIVES environment variable Download directives defined by the PDXTDOWNLOAD_DIRECTIVES environment variable apply to any data set that pdxtdownload receives while the environment variable is in effect.
  • Page 99: Receiver Log

    [jobid.]system.jobname[.step_name].form_name.date.time.PRD.seq# Note: For single-data set jobs, the data set sequence number is always 0. Receiver log The file name of the receiver log is pdxtdownload.portnumber.log. portnumber is the port number that you specified when you created the InfoPrint Manager MVS Download receiver.
  • Page 100: Sample Download Receiver Log

    5016-701 2007-11-11 13:48:31 MDT (ppid 1/pid 1355) port=6001 - receipt started 5016-711 Download arguments: 5016-712 i_inpfile = DEVL.WALLINGK.STEPAAAA.XPORT.2004232.13482935529.PRD 5016-712 i_options = -odatat=line -ofileformat=record -occ=yes -occtype=a -ochars=GF10 -opagedef=P1A06462 -of=F1A10110 -ocop=001 -odatac=block -ojobn=WALLINGK -ous=WALLING -ono=BLDPDEVL -opr=KATHYWALLING-WAITE -oprtqueue=KW7007-ld -opa=forms=XPORT,class=J,destination=BALLA,jobid=JOB00403,OUTGRP=FIRST 5016-712 i_queue = balla 5016-721 Download directives (/dev/fs/C/Program Files/IBM/var/pdxt/pdxtdownload.directives): 5016-722 -l = "all"...
  • Page 101: Temporary Files

    Temporary files pdxtdownload uses several temporary files. The temporary files are in the directory for the MVS Download receiver. The names of these files all use the format pdxtdownload.*.extension: v The value of * depends on whether pdxtdownload merges data sets for jobs that contain several data sets.
  • Page 102 InfoPrint XT Guide...
  • Page 103: Chapter 7. Troubleshooting Infoprint Xt

    Chapter 7. Troubleshooting InfoPrint XT This chapter describes how to diagnose and correct problems when you transform Xerox jobs with InfoPrint XT for Windows (InfoPrint XT). It also describes customer responsibilities for problem determination and how to place a service call to report a problem.
  • Page 104: Problem Determination: The Job Resulted In No Printed Output

    pdpr -p ldest -x job-hold=true drive:\path\jobname Note: An incorrect document format value can also result in no printed Did an InfoPrint Manager header page and an InfoPrint XT error sheet print? InfoPrint XT generates an error sheet if it cannot create any AFP pages for the Xerox job.
  • Page 105 Job ID --- -------------- -------- ------- ----------- ----------- ------------ Document Number -------- --------- -------- ------- Is the actual destination enabled? to convert the job. When it cannot complete the conversion, InfoPrint Manager changes the status of the job to held and does not print any of the job.
  • Page 106 Also, you must start the InfoPrint Manager server with this path in effect. You can enter the echo command from a Windows Command Prompt window to determine if the PATH environment variable includes the directories for the InfoPrint XT...
  • Page 107: Problem Determination: Processing Jobs Through Download For Z/Os

    i 11/11/07 10:25:39 kwwadmin i 11/11/07 10:25:39 i 11/11/07 10:25:39 PRT01-ad i 11/11/07 10:25:39 PRT01-ad i 11/11/07 10:25:39 kwwadmin PRT01-ad i 11/11/07 10:25:39 kwwadmin PRT01-ad X 11/11/07 10:25:41 kwwadmin PRT01-ad X 11/11/07 10:25:41 kwwadmin PRT01-ad X 11/11/07 10:25:41 kwwadmin PRT01-ad Does the Windows system have adequate disk drive space and available memory? Problem determination: Processing jobs through Download for z/OS...
  • Page 108 Does the SDSF Held Output Queue Panel contain an entry that indicates the problem? Does a problem with the InfoPrint Manager MVS Download receiver cause the job to remain on z/OS? Does the job have an entry in the InfoPrint Manager server error log? Does the working directory of the InfoPrint Manager MVS Download receiver contain any .PRD or .JCL files for the job? Are you using download directive -l none ?
  • Page 109: Diagnostic And Informational Files That Infoprint Xt Produces

    Diagnostic and informational files that InfoPrint XT produces If InfoPrint XT cannot process the job, only a header page and an error sheet might print in place of the job data. If errors exist in the output that InfoPrint XT produced, it also records information about the failure.
  • Page 110: X2Afp.lst File

    CLUSTRLIB=NONE XHONORFCB2=NO TWOPASS CAOBS MFDEF=F1AIOMFD XHONORSHIFT=NO XJES3211=YES XPATTERN_SET=300-1 XAFPFUNCTION=IOCA_RT XRESOLUTION=300 XHONORSTAPLE=NO XSTAPLEORIENT=NO XSTAPLESYSGEN=1TON Processing ended with return code 0. The different sections of the pdxtx2afp.log file contain these types of information: 5016-503 Transform arguments (pdxtx2afp): 1 Lists the transform arguments that were in effect for the job. The name in parentheses indicates the component that supplied the arguments.
  • Page 111: Service Coordinator Responsibilities

    variable fixed Processing ended with return code 16 General error 7 occurred (errno 0) Service coordinator responsibilities It is your responsibility to provide a service coordinator for InfoPrint XT. The service coordinator must be a knowledgeable Windows system support person. The service coordinator does these tasks: v Screens all on-site problems before reporting them to make sure that the problem is not a result of an operator error.
  • Page 112: Using The Pdxtcapture Command

    Using the pdxtcapture command After you place a service call, the technical-support representative might ask you to capture information from the InfoPrint XT system. InfoPrint XT provides the pdxtcapture command that you can use to make an image of the working directory for a job or an image of a resource directory.
  • Page 113: Appendix A. Conversion Parameters For Converting Xerox Jobs

    Appendix A. Conversion parameters for converting Xerox jobs Conversion parameters control how InfoPrint XT for Windows (InfoPrint XT) converts the Xerox data stream to the Advanced Function Presentation (AFP) data stream. The conversion parameters are the same, whether the Xerox job is the Line Conditioned Data Stream (LCDS) or the metacode data stream.
  • Page 114 [xcc=ansi | machine] InfoPrint XT Guide v A positive scan value moves the page image to the right in the portrait orientation, or down in the landscape orientation. v A negative scan value moves the page image to the left in the portrait orientation, or up in the landscape orientation.
  • Page 115 [xckdupnlimg= yes | no] [xclb=clustr | clusterlib_name | none] [xcmt2nop=yes | no] [xconvert=yes | no] [xcopies=nnnnn] it passes the type of carriage control it determined to its online (jes3211) carriage-control processing component. This can cause the AFP output that InfoPrint XT generates to be wrong. For more information, see page 99.
  • Page 116 [xcsmmname=yes | no] [xhonorfcb2=yes | no] [xhonorinvert=yes | no] [xhonorshift=yes | no] [xhonorstaple=yes | no] [xinlr=all:cs:cp:cf:pseg:ovly:inlr] InfoPrint XT Guide Descriptor Entry (JDE) or Dynamic Job Descriptor Entry (DJDE) COPIES option. If you do not specify this parameter, either the DJDE in the data stream or in the active JDE determines the number of copies.
  • Page 117 [xinvertalign=no | yes] [xjde=dflt | jde_name] [xjdl=dfault | jdl_name] [xlinecount=n] InfoPrint XT embeds all AFP character sets, code pages, coded fonts, overlays, and page segments that the job requires in the AFP data stream. Specifying xinlr=all is the same as specifying xinlr=cs:cp:cf:ovly:pseg.
  • Page 118 [xlrecl=80 | nnnnn] [xmicrfont=none | all | xerox | xerox+font1:font2:font3 | xerox-font1:font2:font3 | font1:font2:font3] [xpaper=letter | ledger | folio | A3 | A4 | A4LT | B4] InfoPrint XT Guide Specifies the record length of the records in the job. If you specify a corresponding xrecfm=fixed parameter, the valid range is 1 through 32760.
  • Page 119 [xpattern_set=300-1 | 300-2] [xpcctest=yes | no] DJDEs. Use this parameter only if the inline forms do not specify a paper size internally, or if the JDL and JDEs for the job do not specify a paper size. Notes: 1. A4LT is a custom paper size that is 8.5 inches by 11.69 inches, or 216 mm by 297 mm.
  • Page 120 [xrecfm= fixed | variable] [xrptfile=. | path\file] [xshading=xerox | grayscale | [lp]:[mp]:[hp]] InfoPrint XT Guide This prevents InfoPrint XT from verifying the carriage controls in the first few records of the job and it passes the value of the xcc parameter to jes3211.
  • Page 121 [xspacing=none | word | char] [xspcrmi=yes | no] Do not include the brackets in the value; the brackets indicate each position in the value is optional. Include the colons (:) between the positions of the value. If you omit any position, InfoPrint XT uses the default percentage for LIGHT, MEDIUM, or HEAVY.
  • Page 122 [xstaplemax=n] [xstapleorient=yes | no] [xstaplesysgen=nto1 | 1ton] [xtrblanks= no | yes] [xzctrace=yes | no] InfoPrint XT Guide Note: The xspcrmi conversion parameter does not control how InfoPrint XT interprets spacing characters in Xerox fonts that you have previously loaded with the pdxtloadres command. If you specify xspcrmi=yes and the job does not contain FILE DJDE commands, InfoPrint XT does not generate RMI structured fields for any of the fonts the job uses.
  • Page 123 for problem analysis. If you do not specify this parameter, InfoPrint XT does not capture trace information. Use this parameter only at the direction of a technical support representative. [xzdump=yes | no] Captures trace information that a technical support representative can use for problem analysis.
  • Page 124 InfoPrint XT Guide...
  • Page 125: Appendix B. Infoprint Xt Messages: 5016-Nnn

    Appendix B. InfoPrint XT messages: 5016-nnn This section lists the 5016 series of messages that InfoPrint XT for Windows (InfoPrint XT) can issue. Depending on the message, the message might include an additional error return code. See “Return code numbers” on page 113 for explanations of these numbers.
  • Page 126 parse the value of that environment variable. The most likely cause is a problem with the content of the variable. For example, it might require quotation marks because the command contains special characters, or the command might contain an unbalanced set of quotation marks.
  • Page 127 on a separate line. Or, the resources might not exist in the path explicitly specified in the file. You must specify a full path or a relative path in the file. InfoPrint XT also issues this message if the file is empty.
  • Page 128 5016-205 File file is empty. Explanation: The file identified in the message exists, but it does not contain any data. System action: InfoPrint XT cannot process the request. User response: Correct the problem with the file and enter the command again. 5016-209 An error occurred while locking file filename (error ReturnCode).
  • Page 129 provides additional information about why the change action failed. System action: InfoPrint XT cannot process the request. User response: Examine the specified directory and correct the problem. Then, enter the command again. 5016-232 An error occurred while opening directory directoryname (error ReturnCode)..msg Explanation: InfoPrint XT cannot open the directory identified in the message.
  • Page 130 5016-283 An error occurred while reading from command command (ReturnCode)..msg Explanation: InfoPrint XT cannot read the output from the command identified in the message. The message provides additional information about why the read action failed. System action: InfoPrint XT cannot process the request.
  • Page 131 5016-501 Date_Time (pid ProcessID) - transform started. Explanation: InfoPrint XT started to convert the Xerox job to AFP. System action: InfoPrint XT processes the request. User response: This is an informational message and requires no user response. Date_Time (rc ReturnCode) - transform 5016-502 ended.
  • Page 132 User response: Use the information from the error report to correct the problem. Then, submit the job again. 5016-600 Resource load process started for type "resourcetype" Explanation: InfoPrint XT issues this message when it starts to load resources of a specific type. The message identifies the type of resource that InfoPrint XT is currently loading.
  • Page 133: Return Code Numbers

    User response: Use the return code to determine why the correlation process failed and correct the problem. Then, load the resource again. 5016-617 Metrics generation process started. Explanation: During the resource-load process, InfoPrint XT issues this message when it starts to generate the metrics files.
  • Page 134: Return Code Numbers 1-64 In Infoprint Xt Messages

    Table 11. Return code numbers 1-64 in InfoPrint XT messages Error Symbolic constant and explanation EPERM Operation not permitted ENOENT No such file or directory ESRCH No such process EINTR Interrupted function call EIO Input/output error ENXIO Device not configured E2BIG Argument list too long ENOEXEC Exec format error EBADF Bad file descriptor...
  • Page 135: Return Code Numbers 65-127 In Infoprint Xt Messages

    Table 12. Return code numbers 65-127 in InfoPrint XT messages Error Symbolic constant and explanation EHOSTUNREACH No route to host ENOSETUID setuid/setgid bit feature is disabled EPROCLIM Too many processes EUSERS Too many users EDQUOTE Disc quota exceeded N/A Stale NFS file handle N/A Too many levels of remote in path N/A RPC struct is bad N/A RPC version not available...
  • Page 136 InfoPrint XT Guide...
  • Page 137: Appendix C. Resource Converter Messages: 5018-Nnn

    Appendix C. Resource converter messages: 5018-nnn This section lists the messages that InfoPrint XT for Windows (InfoPrint XT) can issue when you load Xerox fonts, images, and logos. Some messages might include an additional error return code. See “Return code numbers” on page 113 for explanations of these numbers.
  • Page 138 5018-818 The image converter did not recognize the internal format of resource resourcename. Explanation: The image converter found an unexpected combination of internal data while it tried to determine the format of the resource. System action: InfoPrint XT cannot convert the image. User response: Verify that the resource is a valid Xerox image resource.
  • Page 139 5018-826 The image converter did not recognize scan orientation transformation input value inputvalue in resource resourcename. Explanation: The transformation input value specified for the scan orientation is not valid. System action: InfoPrint XT cannot convert the image. User response: Verify that the resource is a valid Xerox image resource.
  • Page 140 5018-837 Resource resourcename specifies a maximum sample value of samplevalue. Explanation: InfoPrint XT supports a maximum sample value of one in Restricted Raster Encoding image resources. System action: InfoPrint XT cannot convert the image. User response: Verify that the resource is a valid Xerox image resource.
  • Page 141: Appendix D. Resource Utility Messages And Data Stream Converter Messages: Aioxxxnnnx

    Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx This section lists the messages that the InfoPrint XT for Windows (InfoPrint XT) resource utility and Xerox data stream converter programs can issue. Make sure that you see the appropriate set of messages, depending on whether InfoPrint XT issues them while loading a resource or while converting a job.
  • Page 142 AIOxxx000S Unknown logic error. Explanation: An unexpected error condition occurred in the parameter parser. System action: InfoPrint XT cannot process the resource. User response: If you are converting a Xerox job, make sure that the conversion parameters for the job are valid.
  • Page 143 Explanation: The parameter parser found extraneous data among the keywords. System action: InfoPrint XT cannot process the request. User response: If you are converting a Xerox job, make sure that the conversion parameters and values for the job are valid. See Appendix A, “Conversion parameters for converting Xerox jobs,”...
  • Page 144 AIOxxx230I Processing Correlation Source File... Explanation: This is an informational message that indicates that InfoPrint XT is rebuilding the correlation tables. It requires no user response. AIOxxx231E Line line_number - correlation resource name resource_name contains incorrect characters. Explanation: A resource name in the resource correlation table contains characters that are not valid.
  • Page 145 AIOxxx238I The correlation source processor did not create the table_name correlation table. Explanation: InfoPrint XT found no valid image or logo entries in the correlation source file. Other messages might provide more information about the problem. System action: InfoPrint XT might continue processing, or it might not process a particular resource.
  • Page 146 AIOxxx247I The resource utility created no translation tables: Explanation: The translation source entries in the translation tables contained errors. System action: InfoPrint XT cannot process the resource. User response: If you manually updated the translation source file, correct the file and rerun the failing command.
  • Page 147 AIOxxx259S The resource utility found an inconsistency in Xerox resource filename.filetype: phase_name: error_info Explanation: The program found a resource (filename.filetype) that it cannot process. System action: Processing continues, but InfoPrint XT does not convert the resource. User response: A phase number and diagnostic information follow this message to help identify the problem.
  • Page 148 User response: If you manually updated the correlation table, verify that the entry is correct and that the AFP resource exists. Then, rerun the failing command. Otherwise, report this message to your technical support representative. AIOxxx272W No correlation exists between Xerox resource Xerox_resource and an AFP resource.
  • Page 149 System action: InfoPrint XT cannot process the request. User response: Correct the character and rerun the failing command. AIOxxx283W Undefined cluster name cl_name in cluster database source file cls_name, line line_number, has no current or preferred AFP MMC trays assigned and will be excluded from reformatted cluster database clb_name.
  • Page 150: Names

    AIOxxx299U Resource utility processing aborted due to unrecoverable errors. Explanation: This message occurs when the resource utility program ends abnormally. The previous messages give the reason for abnormal end of the program. System action: InfoPrint XT cannot process the resource. User response: Review the other messages that InfoPrint XT issued and correct the problems.
  • Page 151 resource_list_name for a form resource in a format that is not at the current level. The file does not include some of the required information. System action: InfoPrint XT continues processing the job. User response: Reload the corresponding Xerox form to update the resource list file to the latest format and to create the overlay again.
  • Page 152: Infoprint Xt Data Stream Converter Messages

    as binary zeros, in a text line in a form. It might also occur if you have manually correlated a Xerox font to an AFP font and the AFP font does not have characters that correspond to some of the characters in the Xerox font.
  • Page 153 User response: If you are converting a Xerox job, make sure that the conversion parameters for the job are valid. See Appendix A, “Conversion parameters for converting Xerox jobs,” on page 93. Otherwise, report this message to your technical support representative. AIOxxx001S Specified option for keyword: keyword is too long.
  • Page 154 AIOxxx293I The data stream converter needs Xerox resource resource_name for this conversion. Explanation: InfoPrint XT did not find a required Xerox resource during job conversion. System action: InfoPrint XT cannot complete the conversion. User response: Make sure that you load the resource on the system, and that you rerun the job.
  • Page 155 User response: Make sure that the xcc conversion parameter specifies the correct type of carriage control, and verify that the data stream conversion parameters are correct. Then, convert the job again. AIOxxx431E Resource conversion for inline resource resource_name ended with return code nn. Resource will not be used.
  • Page 156 file resource_list_name matches the information in overlay overlay_name. AIOxxx473E The data stream converter detected one or more missing overlays or overlay resources. Data stream conversion to AFPDS may be successful, but the AFP file will not print correctly. Load the missing resources to ensure correct output.
  • Page 157 AIOxxx491E The transform detected an attempt to reshape graphic characters by using nongraphic Xerox font font_name on page page_number, logical record line_number. Of number active fonts, font_name is number number and no graphic fonts were found in the active font list. AIOxxx491E The transform detected an attempt to reshape graphic characters by using nongraphic Xerox font font_name on page...
  • Page 158 the COLLATE DJDE in the input file and reconvert the job. AIOxxx563W The data stream converter ignored an incorrect COLLATE change request. Explanation: The COLLATE DJDE that InfoPrint XT found is not valid after the first data record of the report.
  • Page 159 AIOxxx574W The data stream converter ignored page-oriented keywords in the DJDE packet on record number due to a prior page oriented DJDE on this page. Explanation: The data stream converter found more than one DJDE packet that contained page-oriented DJDEs on a page. You can only apply one page-oriented DJDE to each page.
  • Page 160 User response: This is an informational message that requires no user response. AIOxxx610E A translation error occurred while processing input character x’EBCDIC_hex’ (ASCII x’ASCII_hex’) at logical record line_number. Code page code_page did not contain EBCDIC character x’EBCDIC_hex’. The data stream converter substituted a blank. The original Xerox font was font_name.
  • Page 161 failed because of insufficient memory. The image graphic uses the naming convention SGnnnnnn. nnnnnn is a number from 0 through 999999. Numbering begins with SG000000 for the first inline graphic found in the data stream, SG000001 for the next, and so on. System action: InfoPrint XT continues to process the job, but the output is not correct.
  • Page 162 AIOxxx712W XHONORSTAPLE is in effect, but reformatted JDL jdl_name/JDE jde_name does not include stapling information. The converter disabled stapling for the current report. Explanation: Although you requested that InfoPrint XT process Xerox stapling commands, you did not reload the JDL and JDE pair in effect after stapling support became available in InfoPrint XT.
  • Page 163 InfoPrint XT created from a Xerox font, report this message to your technical support representative. AIOxxx766S The font processor could not find character translation table table_name in the reformatted Xerox resource path. Explanation: InfoPrint XT did not locate the character translation table identified in the message in the reformatted Xerox resource path.
  • Page 164 AIOxxx773E A resource processor could not find cl_type cluster name cl_name in reformatted cluster database clb_name during processing of STOCKSET stk_name in DJDE packet ending on record record_number. Explanation: A stock reference in a FEED DJDE or in the STOCKSET clb_name during processing of external STOCKSET stk_name invoked by the STOCKS DJDE is correlated to a cluster entry, cl_name, which does not exist in cluster database clb_name.
  • Page 165 AIOxxx779E FEED command in DJDE packet ending on record record_number specified stock reference stk_ref, but no STOCKSET is in use; the data stream converter cannot resolve the stock reference. Explanation: A FEED DJDE specifies a stock reference, stk_ref, but no STOCKSET is in effect. InfoPrint XT ignores the FEED DJDE command.
  • Page 166 InfoPrint XT Guide...
  • Page 167: Appendix E. Djde Report Messages: Alter Through Xmp

    Appendix E. DJDE report messages: ALTER through XMP This section lists the possible messages that you might see in the Dynamic Job Descriptor Entry (DJDE) report generated by InfoPrint XT for Windows (InfoPrint XT), and includes a short explanation of each message. These messages can occur in any order in the DJDE report;...
  • Page 168 BFORM - No overlay will appear on the back of subsequent sheets. Explanation: A BFORM=NONE DJDE cancelled a previous BFORM DJDE. BOF - The new bottom of form line number is number. Explanation: Specifies that number is the line number of the bottom of the form.
  • Page 169 FONTINDEX - The data stream converter will interpret data bytes at offset x as table reference characters, which number the fonts from number and contain font references in the low-order z bits. Explanation: Specifies that the job contains a FONTINDEX DJDE, and identifies the location and the numbering of the font indexes that the data stream converter uses.
  • Page 170 FORMS - The following overlays will appear on the front of subsequent sheets. Overlaycopy ply overlay_name1x to y overlay_nameNx to y Explanation: This message occurs when the job specifies copy-sensitive forms and either SIMPLEX or BFORM. overlay_name1 through overlay_nameN identify the names of the AFP overlays.
  • Page 171 IRESULT - The data stream converter does not support the IRESULT DJDE. Explanation: An IRESULT DJDE, which InfoPrint XT does not support, is present. ITEXT - The data stream converter does not support the ITEXT DJDE. Explanation: An ITEXT DJDE, which InfoPrint XT does not support, is present.
  • Page 172 RFORM - Overlay overlay_name will appear on the front of routing text pages. Explanation: Specifies that the AFP overlay overlay_name will print on all RTEXT pages. ROFFSET - The data stream converter will offset the current sheet. Explanation: An ROFFSET statement is present. InfoPrint XT offsets the current sheet.
  • Page 173 SEFFNT - The data stream converter does not support the SEFFNT DJDE. Explanation: A SEFFNT DJDE, which InfoPrint XT does not support, is present. SEFMAP - The data stream converter does not support the SEFMAP DJDE. Explanation: A SEFMAP DJDE, which InfoPrint XT does not support, is present.
  • Page 174 XSHIFT - The data stream converter will ignore XSHIFT DJDEs. Explanation: The data stream converter found an XSHIFT DJDE, but the conversion parameters include xhonorshift=no. xhonorshift=no is the default. InfoPrint XT does not shift the output. XSHIFT - Printing on subsequent sheets will not shift up or down | to the left or right.
  • Page 175: Notices

    Notices This information was developed for products and services offered in the U.S.A. InfoPrint Solutions Company may not offer the products, services, or features discussed in this document in other countries. Consult your local InfoPrint Solutions Company representative for information about the products and services currently available in your area.
  • Page 176: Programming Interfaces

    InfoPrint Solutions Company may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: InfoPrint Solutions Company, LLC...
  • Page 177: Trademarks

    + — — — — — – — End of Programming Interface information — — — — — - — - + Trademarks These terms are trademarks or registered trademarks of Ricoh Co., Ltd., in the United States, other countries, or both:...
  • Page 178 InfoPrint XT Guide...
  • Page 179: Glossary Of Selected Infoprint Solutions Company Terms

    (2) An interface that lets users enter commands on a command line, such as the command line of a Windows Command Prompt window. Contrast with Graphical User Interface. common resource. In InfoPrint XT, resource files that...
  • Page 180 data stream. (1) The commands, control codes, data, or structured fields that are transmitted between an application program and a device such as printer or nonprogrammable display station. (2) All data sent through a data channel in a single read or a single write operation.
  • Page 181 graphics. (1) Charts, pictures, illustrations, and tables created from fundamental drawing units such as lines, curves, and polygons. (2) Images, text, or a combination of both that you can put on an overlay by name. graphical user interface (GUI). A type of computer interface that presents a visual metaphor of a real-world scene, often of a desktop, by combining high-resolution graphics, pointing devices, menu bars...
  • Page 182 maps the job to the user who submitted it. InfoPrint Manager maps a local job ID to a global job ID. logical destination. In InfoPrint Manager, an object to which users or programs submit jobs. The destination routes the jobs to one or more actual destinations that represent output devices, such as printers, electronic mail systems, or fax machines.
  • Page 183 their own environment and are often used as electronic forms. (2) A collection of predefined static data, such as lines, shading, text, boxes, or logos that can merge with variable data on a sheet while printing. page. (1) In AFP, a data stream object delimited by a Begin Page structured field and an End Page structured field.
  • Page 184 reformatted Xerox resource path. Synonymous with metrics directory. resource group. In InfoPrint XT, resource files that are in the %PDXTWORKDIR%\resources\resgrp directory and the %PDXTWORKDIR%\resources\resgrp\ metrics directory. These resources are the AFP resource files and the metrics files that correspond to Xerox resources that you have loaded on the system.
  • Page 185 advances in networking server capability, parallel processing, and object-oriented programming. Glossary of selected InfoPrint Solutions Company terms...
  • Page 186 InfoPrint XT Guide...
  • Page 187: Glossary Of Selected Xerox Terms

    Glossary of selected Xerox terms CMD. The file type, or extension, of a Xerox command file. These text files contain command-language statements for groups of related commands. The commands can do tasks, such as setting up a printing environment and running a specific job.
  • Page 188 GHO. Graphics Handling Option. Graphics Handling Option (GHO). A collection of hardware and software that enables a Xerox LPS printer to print encoded, digitized graphic images. HFDL. Host Forms Description Language. Host Forms Description Language (HFDL). A Xerox host-resident software product (on z/OS and z/VM) that customers use to create electronic forms for Xerox LPS printers.
  • Page 189 information about the banner pages for accounting purposes, or it might delimit reports in a print job. BDELETE Deletes specified blocks from offline data to prevent them from printing. BSELECT Selects specified blocks from offline data to cause them to print. Pulls a single sheet of paper from the auxiliary RAUX paper tray.
  • Page 190 strings defined by the RSTACK or BANNER command serve to separate the reports. resource. See non-printable resource and printable resource. signature font. A font that contains one or more images, logos, or signatures that are tiled into many characters. You can reproduce the image by printing the correct sequence of characters from the font.
  • Page 191: Bibliography

    Bibliography You can find additional information about products that you can use with InfoPrint XT for Windows (InfoPrint XT) in the publications listed in this bibliography. The titles and order numbers may change from time to time. To verify a current order number or a current title, consult your marketing representative.
  • Page 192 InfoPrint Solutions Company printers v InfoPrint 2190, 2210, & 2235 Printers (MT 2707): Planning Guide, G550-0952 v InfoPrint 2060ES/2075ES/2090ES/2105ES: Finishing Guide for Printing, S544-5845 v InfoPrint 40 Infoprint 32: User’s Guide, S544-5484 v InfoPrint 70: Introduction and Planning Guide, GA18-7726 v InfoPrint 70 Plus: Introduction and Planning Guide, G544-5869 InfoPrint XT Guide...
  • Page 193: Special Characters

    Index Special characters %PDXTINSTDIR%, definition 13 permanently removing 19 %PDXTINSTDIR%\testjob directory 16, 26 %PDXTWORKDIR% definition 13 permanently removing 19 %PDXTWORKDIR%\resources\resgrp directory 37 %PDXTWORKDIR%\resources\resgrp\metrics directory 38 %PDXTWORKDIR%\resources\resgrp\pdxtloadres directory 41 %PDXTWORKDIR%\resources\resgrp\xrxres directory 38 %PDXTWORKDIR%\resources\common directory 37 %PDXTWORKDIR%\resources\common\metrics directory 38 %PDXTWORKDIR%\resources\common\pdxtloadres directory 41 %PDXTWORKDIR%\resources\common\xrxres directory 38 C:\OtherDirectory directory 37 C:\OtherDirectory\metrics directory 38...
  • Page 194 95 xclb conversion parameter 95 CMD files blocking 56 deblocking 55 commands cd 17 echo 86 entering, Windows Command Prompt window xiii fold 25 lpr 4 pdcreate 14 pddisable 19 pdenable 19, 86 pdls 14, 86 pdmsg 84...
  • Page 195 directories (continued) %PDXTWORKDIR%\resources\common\pdxtloadres 41 %PDXTWORKDIR%\resources\common\xrxres 38 C:\OtherDirectory 37 C:\OtherDirectory\metrics 38 C:\OtherDirectory\pdxtloadres 41 C:\OtherDirectory\xrxres 38 C:\Program Files\IBM\Infoprint XT 13, 21 C:\Program Files\IBM\Infoprint XT\var\pdxt 19, 21 C:\Program Files\IBM\Infoprint XT\var\pdxt\resources\ common 13 directory-name conversion, PDXT_WINPATH2UNIX environment variable 22 disk drive space, checking Windows 87 DJDE commands reports generating 100...
  • Page 196 FILE DJDE support (continued) processing limitations, concurrent jobs 4, 66 resource-load directory 61 file name conventions, pdxtdownload processing input data sets 78 receiver log 75, 79 temporary files 81 files resname.axx.failed 41 resname.ext.lst 41 xxx_corr.lst 41 xxx_metr.lst 41 xxx_metr.xrl 41 jobattr.ipm 29 line2afp.lst 25 mvsdsubm 67...
  • Page 197 JCL parameters (continued) SEGMENT 71 TITLE 71 TRC 71 UCS 71 jes3211 carriage-control processing, enabling 29 job-comment attribute 74 job-hold attribute 83 job-name attribute 70 job-state-reasons attribute 85 jobattr.ipm file 29 jobs job ID, UNKNOWN 63 job name, UNKNOWN 63 name format jobname-jobID-n 64 restrictions on Xerox 4...
  • Page 198 PDXT_WINPATH2UNIX environment variable 22 PDXT_XR2FAPI_TRACE environment variable 24 PDXT_XR2IAPI_TRACE environment variable 24 pdxt-2.1..0.nn.exe file 18 pdxtblkres command 56 restrictions 57 return codes 57 streams used 57 syntax 56 pdxtcapt.job file 92 pdxtcapt.res file 92 pdxtcapture command 92 pdxtclnwork command 92 pdxtcrtxform command 14 pdxtdblkres command 55 restrictions 56...
  • Page 199 restrictions, InfoPrint XT 240-pel printer support 8 accounting limitations 4 AFP DBCS fonts, FOCA conformance 8 channel connections 8 compilers, JSL and FSL 8 FILE DJDEs, concurrent job processing 4, 66 FTP 8 grayscale substitution 5 highlight color forms 5 image processing 5 metacodes 6 PDL commands 6...
  • Page 200 underscores, syntax diagrams xiii uninstalling InfoPrint XT 19 UNIX emulation tools, Microsoft SFU 11 SUA 11 UNKNOWN job ID value 21, 63 job name value 21, 63 updates, to InfoPrint XT software applying 18 rejecting 19 user account name, checking InfoPrint Manager status 16 user-id-text attribute 71, 81 variable data directory, changing 22 version...
  • Page 202 Program Number: 5799-RZA Printed in USA GLD0-0025-01...

This manual is also suitable for:

Infoprint xt

Table of Contents