InfoPrint XT for Windows: Installation Guide and User’s Guide Version 2 Release 1 GLD0-0025-01
InfoPrint XT for Windows: Installation Guide and User’s Guide Version 2 Release 1 GLD0-0025-01
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. This edition replaces GLD0-0025-00. Internet Visit our home page: http://www.infoprint.
Contents Figures . . . . . . . . . . . . . . vii Adding Windows user account names for InfoPrint Manager security . . . . . . . Testing the InfoPrint XT installation . . . . . Testing with the pdxtloadres and pdxtx2afp commands . . . . . . . . . . . . . Testing with InfoPrint Manager . . . . . . Applying an InfoPrint XT product update . . . Rejecting an InfoPrint XT product update . . Permanently removing the InfoPrint XT software . Tables . . . . . . . . . . . . . . . ix About this publication . . . . .
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 . Examples: pdxtloadres command . . . . . Scanning a job for required resources with the pdxtx2afp command . . . . . . . . . .
InfoPrint Solutions Company printers . . . . . 172 Index . . . . . . . . . . . . . . .
vi InfoPrint XT Guide
Figures 1. 2. 3. 4. 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 . 28 . 53 54 5. 6. 7. 8. Sample correlation entries for Xerox logos Sample z/OS routing-control data set . . . Completed attribute mapping file . . . . Sample Download receiver log . . . . . 54 . 68 . 73 .
viii InfoPrint XT Guide
Tables 1. 2. 3. 4. | | 5. 6. 7. 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 . . . . . . . . . . . . . © Copyright InfoPrint Solutions Company 2004, 2007 8. .
x InfoPrint XT Guide
About this publication This publication describes how to install, configure, and use InfoPrint® XT for 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™ (IPDS™) printers. You can use InfoPrint XT with InfoPrint Manager for Windows (InfoPrint Manager) or as a stand-alone transform.
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. Chapter 7, “Troubleshooting InfoPrint XT,” on page 83 Describes how to diagnose and correct problems that might occur when you load Xerox resources or process Xerox jobs.
Understanding the syntax notation and the use of special characters These rules apply to the syntax diagrams and examples that this publication contains: v Text that you type is case-sensitive. For example, p0612c.fnt and F$P0612C; type the font names in lowercase and uppercase characters exactly as they are shown. v Do not type any vertical bars, underscores, or brackets that command examples include: – A vertical bar or bars between two or more entries means that you can specify only one of the values.
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. Enter pdxtman pdxt or enter the pdxtman command by itself.
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. The numbering sequence begins with AIO00001.
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.
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. InfoPrint XT now can convert shading patterns and shading characters to grayscale.
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.
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. Note: This publication identifies the system on which you install InfoPrint XT as the Windows system.
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. Table 1.
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 v v v v ISL JSL MSC PCH TMP InfoPrint XT copies information for these non-printable resources when you load them. InfoPrint XT does not use these resources; it copies them for reference purposes only.
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. You can use it to transfer Xerox jobs over a TCP/IP network to a directory on the Windows system.
| | | | | | | | | | Grayscale substitution for Xerox shading 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.
Highlight-color job processing 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. The jobs print in black and white. OTEXT messages You can process jobs that contain OTEXT messages with InfoPrint XT. However, InfoPrint XT does not display the OTEXT message text or suspend printing.
| | | code points. This function does not correct any other type of code page conflicts that occur after manually correlating Xerox resources to AFP resources. Stapling support 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. The default is that InfoPrint XT ignores stapling commands.
Note: For more information about the xhonorstaple, xstapleorient, xstaplesysgen, and xstaplemax parameters, see Appendix A, “Conversion parameters for converting Xerox jobs,” on page 93. 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.
Table 2.
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. v ⁴ Restrictions apply to this command. See page 6. v ⁵ If you compile an FSL to an FRM that contains LOGO references in its internal font list or logo list, InfoPrint XT supports those references.
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. You might also want to install an optional software product that can benefit the installation.
| | | | | 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. | | | | | | Microsoft Subsystem for UNIX-based Applications | | | | | From the Windows Server 2003 R2 Standard Edition workstation: 1.
5. You must complete other configuration tasks for combined InfoPrint Manager and InfoPrint XT installations. See “InfoPrint Manager configuration tasks.” Installing InfoPrint XT To 1. 2. 3. 4. 5. 6. 7. install InfoPrint XT: Close any applications that you are running on the Windows system. Log on to the system with a Windows computer administrator account. Put the InfoPrint XT for Windows Base CD in the CD-ROM drive. The installation program starts automatically.
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-formatssupported attribute.
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.
Return codes from the pdxtsetdest command Return codes from the pdxtsetdest command are: 0 The command successfully updated the specified actual destinations. EINVAL An error exists with one of the command options. E2BIG You specified an actual destination name that was too long. ENOATTR You specified a command option without a value. ENOENT You did not specify an actual destination name. other Any other return codes that are not in this list are return codes from C functions.
4. Copy the parameter mapping file for the test job to the %PDXTWORKDIR% directory: copy pdxtx2afp.map C:\Program Files\IBM\Infoprint XT\var\pdxt | You can also use Windows Explorer to copy the file. 5. Submit the test job. Replace AFPfile with a file name that you choose: pdxtx2afp -i pdxttest.xrxin -o AFPfile -p -opa=jobname=PDXTTEST InfoPrint XT writes information from the conversion process to standard error. 6.
InfoPrint XT PR111E A a 0 A a 0 B b 1 B b 1 C c 2 C c 2 D d 3 D d 3 E e 4 E e 4 F f 5 F f 5 G g 6 G g 6 H h 7 H h 7 I i 8 I i 8 J j 9 J j 9 K k ! K k ! L l @ L l @ M m # M m # N n $ N n $ O o % O o % P p ? P p ? InfoPrint XT Q q & Q q & R r * R r * S s ( S s ( T t ) T t ) U u U u - V v _ V v _ W w = W w = X x + X x + Y y ; Y y ; Z z : Z z : P0612C P0612C P0612C P06BOB P06BOB P06BOB PR111E Figure 1.
Rejecting an InfoPrint XT product update If you apply an InfoPrint XT update, and then want to return the Windows system to a previous version of InfoPrint XT, use this procedure. This procedure does not affect any of the resources or settings specific to InfoPrint XT. To reject an InfoPrint XT product update: 1. Click Start→Control Panel→Add or Remove Programs. 2. Highlight the InfoPrint XT entry and click Change / Remove. Follow the instructions to complete the removal. 3. Restart the Windows system. 4.
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.
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. In combined InfoPrint Manager for Windows (InfoPrint Manager) and InfoPrint XT installations, ServerName_JobIdentifier is the InfoPrint Manager job identifier.
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. For example, InfoPrint XT uses subdirectories of %PDXTWORKDIR%\resources to store information for Xerox resources that you have loaded.
Table 3. DOS-to-UNIX directory conversions (continued) | | Command PDXT_WINPATH2UNIX setting Resulting directory pdxtloadres -n "/directory/*" 1 /dev/fs/C/directory ² pdxtloadres -n "/directory/*" 0 /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. Notes: 1.
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" v To specify one option and value, and to specify the -x option with more than one value, also use double quotation marks: -g payroll -x "xjdl=tonl xjde=dflt xclb=pay" Note: InfoPrint XT uses the value of the PDXTX2AFP_ARGS
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. Set the PDXT_INTMSGIDS variable to 1 to include module and line number information.
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. InfoPrint XT can use a parameter mapping file, which you create, to streamline the process of setting conversion parameters.
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. v The values for the keywords are case-sensitive. For example, prt1 and PRT1 are two distinct values. v You can use asterisks and question marks as wildcard characters for keyword values.
#-----------------------------------------------------# # 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 CL
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. You primarily use the transform directives for diagnostic purposes or when you require special modifications to the transform process.
the Xerox input to, and the AFP output from the conversion process. You can also specify more than one value on a single occurrence of the -t directive. [-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.
#------------------------------------------------# # 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. See “Using the pdxtx2afp command to process Xerox jobs” on page 61.
Table 5. InfoPrint XT NOP structured field format (continued) Offset Length Value Description 1 2 8-32767 Total length of the structured field. This does not include the carriage control byte. 3 3 X'D3EEEE' MO:DCA No Operation structured field identifier. 6 1 X'00' Flags. InfoPrint XT always uses X'00'. 7 2 X'0000' Reserved bytes. InfoPrint XT always uses X'0000'. 9 8 AIOX2AFP This parameter specifies that InfoPrint XT generated the NOP structured field.
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: | | | | | | A CTLHEADR record that indicates the possible presence of NOPs generated from C DJDEs might contain: ----+----1----+----2----+----3 !..LÓÓ...AIOX2AFP..CTLHEADR... 501DEE000CCDEFCCD00CEDCCCCD800 A0D3EE000196721670033385149000 ----+----1----+----2----+----3 !..LÓÓ...AIOX2AFP..CTLHEADR...
| Bit 0: Reserved for future use. | Bit 1: Reserved for future use. | Bit 2: Reserved for future use. | Bit 3: Reserved for future use. | Bit 4: Reserved for future use. | Bit 5: Reserved for future use. | Bit 6: Reserved for future use. | Bit 7: Reserved for future use. | The data for the XRXCDJDE record is the comment text in EBCDIC. | | | | | An XRXCDJDE record for comment text might contain: ----+----1----+----2----+----3----+----4----+----5----+ !..LÓÓ...AIOX2AFP..XRXCDJDE...
| ² Bins are numbered 1 through 255. | For information about the xcsmmname conversion parameter, see page 96. Chapter 3.
36 InfoPrint XT Guide
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. Enter this command: pdxtman pdxt_resources For an overview on using the pdxtloadres command, which you use to load the Xerox resources, see the pdxtloadres man page.
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.
Table 8. Xerox resource extensions, AFP prefixes, and metrics extensions (continued) Xerox resource type and extension Resulting InfoPrint XT AFP prefixes Job Source Library - .jsl Logo - .lgo Resulting InfoPrint XT metrics extensions .ajs SL .alg Miscellaneous - .msc .ams Page Descriptor Entry - .pde .apd Patch - .pch .apc Stockset - .stk .ast Routing Text - .tst .ats Temporary - .tmp .atp ¹ Not generated for double-byte character set fonts.
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.
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.
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. You can also use the pdxtloadres command to delete resources.
Presentation Text Object Content Architecture (PTOCA) text-string characters. This is the default. | | | | | spcrmi | | | | 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. | | | | | | | Notes: 1. Restrictions apply when you use the -b option. See page 6. | | | InfoPrint XT interprets spacing characters in the font as Relative Move Inline (RMI) structured fields.
| | | any position, InfoPrint XT uses the default percentage for LIGHT, MEDIUM, or HEAVY. These are examples of values you can specify: | | | -c :8:16 | | -c 3 InfoPrint XT uses 3% coverage for LIGHT shading, 10% for MEDIUM, and 15% for HEAVY. | | -c :11 InfoPrint XT uses 5% coverage for LIGHT shading, 11% for MEDIUM, and 15% for HEAVY. | | -c ::14 InfoPrint XT uses 5% coverage for LIGHT shading, 10% for MEDIUM, and 14% for HEAVY.
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. [-g common | resgrp] Specifies a resource group name that InfoPrint XT uses to build subdirectories in the %PDXTWORKDIR%\resources directory.
2. If you are loading resources, you can specify Xerox resources with names that follow IBM Infoprint XT Extender for z/OS naming conventions. See Table 9 on page 48. 3. If you are loading resources, you can specify the -l option without a value. InfoPrint XT tries to load resources using the retry file. See page 40. 4. If you use both the -l option and the -i option, do not include path information with the resource names. Specify only the resource names in lowercase characters. 5.
| 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. Separate the font names with colons (:). The fonts you specify can be any Xerox fonts.
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. 3. When you load resources, the pdxtloadres command also recognizes IBM Infoprint XT Extender for z/OS naming conventions for Xerox resource files. You can transfer Xerox resources from z/OS to the Windows system using a method such as File Transfer Protocol (FTP).
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. Note: If the directory that you specify does not exist, InfoPrint XT issues an error message. [-p 300_1 | 300_2] Specifies the type of shading patterns that InfoPrint XT uses when it converts Xerox forms. Valid values are: [-r] | | 300_1 Specifies the shading patterns used by Xerox 9700, 4x50, and 4x90 printers. This is the default.
fd2 (STDERR) The command writes messages to this stream. Return codes from the pdxtloadres command Return codes from the pdxtloadres command mean: 0 The command successfully loaded or deleted all the specified resources. EINVAL An error exists with one of the command options. E2BIG The command contains too many command options. ENOATTR You specified a command option without a value, or you did not specify a required command option. ENOENT The command did not locate the resources to load or delete.
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. For the syntax of the pdxtx2afp command and examples of its use, see “Using the pdxtx2afp command to process Xerox jobs” on page 61.
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. Note: If Xerox spacing characters in fonts cause code page conflicts after you manually correlate a Xerox font to an AFP font, you can change how InfoPrint XT interprets the spacing characters.
Figure 3 shows the various types of entries that you can make in a manual font correlation table for single-byte Xerox fonts. F F F F F F F CRC12P RK141P CSFL30 CSFP01 CSFP02 CSFP03 CSFP04 X2AFP X2AFP X2AFP X2AFP X2AFP X2AFP X2AFP X0P0612C C0UN411E S1L3021 S1P0121 S1P0122 S1P0123 S1P0124 T1UN411E 41 A 21 Y=-7 F X=3 Y X=-3 Y=4 Figure 3.
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. A positive value moves the page segment down on the page. A negative value moves it up. Figure 4 shows the various types of entries that you can make in a manual correlation table for Xerox images.
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.
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) If you do not specify any resource file names with the command, the command reads the blocked resource from standard input.
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. [file ...] The name of the Xerox resource file to block. When the command blocks the resource, it replaces the contents of the existing file with the blocked output.
58 InfoPrint XT Guide
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.
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.
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. The path that the InfoPrint Manager resource-context document attribute specifies. 2. The path that the PSFPATH environment variable specifies. 3. The path that the InfoPrint Manager resource-context actual destination attribute specifies. Notes: 1.
The syntax of the pdxtx2afp command is: pdxtx2afp [-i inputfile | -] [-o outputfile | -] [[-g common | group ]|[-r resourcepath]] [-x "xjdl=dfault xjde=dflt" | "cparms"] [-p passthru_values] [-t "directives"] [-w workingdirectory] [-i inputfile | -] Specifies the name of the original Xerox LCDS or metacode job file. If you specify a dash, -, for this command option, InfoPrint XT reads from standard input (STDIN). If you do not specify the -i command option, InfoPrint XT reads from STDIN.
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. dest is a value from 1 through 8 characters. forms=form Specifies the name of the form for the job. This corresponds to the FORMS parameter that you specify if you submit the job with JCL.
successfully. If you do not specify this command option, InfoPrint XT uses a subdirectory of the directory that the PDXTWORKDIR environment variable specifies as the working directory. InfoPrint XT builds a subdirectory name of jobname-jobid-n. jobname and jobid come from the -p -opa values, and n is a sequence number. For more information about the PDXTWORKDIR environment variable, see “Controlling the working directory that InfoPrint XT uses for variable data (PDXTWORKDIR)” on page 22. Notes: 1.
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 — — — — — - — + 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.
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. You can also specify that InfoPrint XT embeds all types of printable resources.
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). It is a separately orderable feature of IBM Print Services Facility (PSF) for z/OS. When you use Download for z/OS to send jobs for processing by InfoPrint XT, you use these major components: 1.
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. You can use the pdxtdownload program to receive other data streams, such as PCL and PostScript jobs. This publication does not describe how to process PCL or PostScript jobs.
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. See the InfoPrint Manager publications for detailed information about creating MVS Download receivers. This is an abbreviated version of the steps, with information that is pertinent to InfoPrint XT: 1.
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. Other values, such as the job identifier, come from z/OS itself. The pdxtdownload program translates most of these options to InfoPrint Manager attributes.
Table 10.
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.
#-----------------------------------------------# # 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
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.
nosubmit Does not submit jobs to InfoPrint Manager. Note: Use this download directive only at the direction of a technical support representative. -j -l -m 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: yes pdxtdownload adds the z/OS job identifier to the input file name. This is the default. no pdxtdownload does not add the z/OS job identifier to the input file name.
single job that contains one document for each copy of each data set. Use this directive for data sets that contain data streams other than Xerox LCDS or metacode, such as PCL or PostScript data sets. none pdxtdownload submits each individual data set to InfoPrint Manager as a separate job that contains a single document. If the JCL specified a number of copies, pdxtdownload sets the results-profile attribute for the job.
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. If you specify a2m=none and addmcc=none, pdxtdownload ignores the addskip operand.
pdxtdownload passes both the destination-name-requested attribute and the initial-value-document attribute. attr pdxtdownload uses the entire value as InfoPrint Manager attributes. For example, if the PRTQUEUE statement has this value: PRTQUEUE='room-text=B12-4 title-text=DRAFT' pdxtdownload passes the room-text and title-text attributes to InfoPrint Manager. ignore pdxtdownload ignores the PRTQUEUE value.
[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. The receiver log is in the directory for the MVS Download receiver.
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.
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. If pdxtdownload merges data sets, the value is the port number on which the data set was received. If pdxtdownload does not merge data sets, the value is pidnnnnn.
82 InfoPrint XT Guide
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. Note: Some topics in this chapter use the term ServerName_JobIdentifier.
pdpr -p ldest -x job-hold=true drive:\path\jobname Note: An incorrect document format value can also result in no printed output. 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. The error sheet prints after the InfoPrint Manager header page and includes messages from the transform process. See “Diagnostic and informational files that InfoPrint XT produces” on page 89 for more information.
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. You can issue these commands to do diagnostic tests if nothing prints for the job: v Determine whether InfoPrint Manager still has control of the job and determine the job number for the job. Enter: pdls -f "job-name=jobname" jobname is the actual name of the job.
Note: InfoPrint Manager sets the job state to pending for a job that you submit when the actual destination is disabled. You can issue these types of pdls commands to determine the job state: | | | pdls -f "job-name=jobname" pdls jobnumber Does the InfoPrint XT configurable transform object exist in the InfoPrint Manager server? InfoPrint Manager does not automatically provide the InfoPrint XT configurable transform object. You must explicitly create the transform object during InfoPrint XT installation.
Note: The C:\Program Files\IBM\InfoPrint XT portion of the path is the default directory in which the InfoPrint XT installation program installs files. Depending on the installation, you might have selected a different directory during installation. If the PATH value does not include the InfoPrint XT executable and local directories, update the environment variable through standard Windows interfaces. See “Setting environment variables” on page 21.
v The JCL does not select a z/OS printer. The JCL selects a printer based on parameters such as DEST, CLASS, and FORMS. See the SDSF Printer Panel on z/OS for a possible printer based on these parameters. v You have not drained and restarted the z/OS printer after making changes to the routing-control data set. You must drain and restart the z/OS printer to pick up any changes you make. v The z/OS printer is in a state other than INACTIVE. Examine the SDSF Printer Panel to check for this problem.
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. To determine the exact cause of the problem, you can use the listing files that InfoPrint XT produces.
CLUSTRLIB=NONE XHONORFCB2=NO TWOPASS CAOBS MFDEF=F1AIOMFD XPATTERN_SET=300-1 XAFPFUNCTION=IOCA_RT XRESOLUTION=300 XHONORSTAPLE=NO XSTAPLEORIENT=NO XSTAPLESYSGEN=1TON XHONORSHIFT=NO XJES3211=YES 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.
variable fixed nfs 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.
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. This image is a compressed tar file that the technical-support representative can use as an aid in problem determination.
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. How you specify the conversion parameters depends on whether you use InfoPrint Manager for Windows (InfoPrint Manager) with InfoPrint XT.
| | 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. v A positive dot value moves the page image up in the portrait orientation, or to the right in the landscape orientation. v A negative dot value moves the page image down in the portrait orientation, or to the left in the landscape orientation.
| | | | | | | | | | | | | | 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. [xckdupnlimg= yes | no] Specifies whether InfoPrint XT checks inline images to prevent duplicate image processing when it converts online jobs.
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. [xcsmmname=yes | no] Specifies how InfoPrint XT derives the medium map names that it uses in the inline form definition for a job. The default is that InfoPrint XT uses sequentially numbered names that are not related to the contents of the medium maps. The default numbering begins with AIO00001.
all 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. cs InfoPrint XT embeds all AFP character sets that the job requires in the AFP data stream. cp InfoPrint XT embeds all AFP code pages that the job requires in the AFP data stream. cf InfoPrint XT embeds all AFP coded fonts that the job requires in the AFP data stream.
[xlrecl=80 | nnnnn] 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. If you specify xrecfm=variable, the valid range is 1 through 32756. If you do not specify this parameter, the default is 80.
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. 2. The value of this attribute affects how InfoPrint XT processes jobs that contain FILE DJDE commands.
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. | | | [xrecfm= fixed | variable] Specifies the record format of the records in the job. For fixed length records, as specified by xrecfm=fixed, the xlrecl parameter specifies the length of the record. This is the default. xrecfm=variable specifies that the records are variable length, with a 2-byte length field at the beginning of each record.
| | | | | 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. These are examples of values you can specify: | | | xshading=:8:16 InfoPrint XT uses 5% coverage for LIGHT shading, 8% for MEDIUM, and 16% for HEAVY.
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. In this case, reload the fonts that the job requires with the pdxtloadres command and use the -b option.
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. 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.
104 InfoPrint XT Guide
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. 5016-001 The command option -option is not valid. Explanation: You entered a command and included an option that is not valid. The message text identifies the option.
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. System action: InfoPrint XT cannot process the request. User response: Correct the value of the environment variable and enter the command again. | 5016-010 One or more required command options are missing.
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. System action: InfoPrint XT cannot process the request. User response: Correct the problem with the input list file and enter the command again. 5016-103 The input pattern-matching string used for the search did not match any valid resources.
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. System action: InfoPrint XT cannot process the request. User response: Correct the AFP data stream. Then, enter the command again. If you cannot determine the cause of the problem, report this message to your technical support representative. User response: Correct the problem with the file and enter the command again.
provides additional information about why the change action failed. System action: InfoPrint XT cannot process the request. System action: InfoPrint XT cannot process the request. User response: Use the information that the message provides to correct the problem. Then, enter the command again. User response: Examine the specified directory and correct the problem. Then, enter the command again. 5016-250 5016-232 An error occurred while opening directory directoryname (error ReturnCode). ...
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. User response: Use the information that the message provides to correct the problem. Then, enter the command again.
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. 5016-509 Explanation: This message, with message 5016-510, lists the commands that make up transform processing. System action: InfoPrint XT processes the request. User response: This is an informational message and requires no user response.
User response: Use the information from the error report to correct the problem. Then, submit the job again. Note: InfoPrint XT overwrites the listing file each time you use the pdxtloadres command. 5016-612 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. System action: InfoPrint XT processes the request.
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. finishes copying the AFP resources and the metrics files to the appropriate directories. System action: InfoPrint XT processes the request.
Table 11.
Table 12.
116 InfoPrint XT Guide
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. 5018-801 An error occurred while opening file filename (error ReturnCode). ...msg Explanation: InfoPrint XT could not open the file identified in the message.
5018-818 The image converter did not recognize the internal format of resource resourcename. 5018-822 Explanation: The resource converter found a logo whose format is not single-byte-character-set (SBCS) with ASCII code points. Therefore, the converter cannot create an AFP page segment from the resource. 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.
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. If it is valid, contact your technical support representative. 5018-827 The code page codepage does not contain valid AFPDS.
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. If it is valid, contact your technical support representative. 5018-838 Resource resourcename specifies an incomplete highlight color ink name.
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.
the user that the resource utility found a possible problem in the input resource. However, the resource or resources processed successfully. E Error. Processing continues. This corresponds to return code 8. This indicates an error that caused InfoPrint XT to complete a default action.
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,” on page 93. Otherwise, report this message to your technical support representative. AIOxxx203S code_module could not read parameters due to error_condition.
correlation table, complete the incomplete record and rerun the failing command. Otherwise, this indicates an internal error in InfoPrint XT. Report this message to your technical support representative. 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.
| | | | 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. AIOxxx243E Not enough records in translation table table_name on line line_number.
different from the paper size defined internally in the form. InfoPrint XT used the internally specified paper size. 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.
User response: Review the other messages and correct the problems. Then, load the resources again. AIOxxx259S The resource utility found an inconsistency in Xerox resource filename.filetype: AIOxxx265I The resource utility skipped no Xerox resources. phase_name: error_info Explanation: The program found a resource (filename.filetype) that it cannot process. Explanation: This is an informational message. Other messages indicate whether InfoPrint XT successfully completed the task.
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. Explanation: The resource correlation table does not contain a correlation entry for the Xerox reformatted resource Xerox_resource.
System action: InfoPrint XT cannot process the request. AIOxxx290U The resource utility could not find the source_type source file. 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. System action: InfoPrint XT cannot process the request.
AIOxxx299U Resource utility processing aborted due to unrecoverable errors. AIOxxx444I The number of image references in form form_name was number. Explanation: This message occurs when the resource utility program ends abnormally. The previous messages give the reason for abnormal end of the program. .img name Page segment name img_name pseg_name img_name pseg_name . . . System action: InfoPrint XT cannot process the resource.
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. AIOxxx472E Overlay overlay_name does not match the overlay available when the transform converted resource_list_name.
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. Or, a character translation table was altered so that a character in the job does not map to the correct character in the AFP font. System action: InfoPrint XT continues processing. User response: Correct the form or correlation and reload the form.
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. Maximum length is length. Explanation: The parameter parser found a value for a keyword that is too long. System action: InfoPrint XT cannot process the request.
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. You might also receive this as an informational message when you scan jobs for required resources.
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. | | | Explanation: InfoPrint XT cannot dynamically load the resource that the message identifies. A FILE DJDE in the job specified the resource.
| file resource_list_name matches the information in | overlay overlay_name. AIOxxx483W Numeric argument numeric_argument is outside the range of permitted values. The transform will use a value of default_value. 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.
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_number, logical record line_number. Of number active fonts, font_name is number number.
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. System action: InfoPrint XT continues processing the job. User response: Make sure of the correct placement of the COLLATE DJDE in the input file and reconvert the job. AIOxxx564E djde_name - DJDE value value is not valid for the specified conversion units.
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. AIOxxx582E FILE - The data stream converter does not support inline files in the 80-byte card image format (file input format parameter C) and may print their contents as unusable data. The converter only supports the LPS format (file input format parameter L).
| User response: This is an informational message that | requires no user response. AIOxxx624E The tiff2afp transform returned error code error_code while processing inline graphic number number. 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.
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. User response: Verify that the inline graphic is correct. If it is, report this message to your technical support representative.
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.
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. System action: The process fails.
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.
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. System action: InfoPrint XT ignores the FEED DJDE and pulls paper from the main bin. User response: Verify that the job specifies the correct FEED DJDE and the correct STOCKSET.
146 InfoPrint XT Guide
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; they are listed in alphabetic order by DJDE name here.
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. DJDE - Explanation: Specifies that line_number contains one or more DJDEs (djde_record). | Note: There is no DJDE with the name DJDE. The | message title is for explanation retrievability | only.
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. x, y, and z are integer values. FONTS - .fnt name fnt_name fnt_name . . . The number of fonts listed was number.
FORMS - The following overlays will appear on the front of subsequent sheets. IMAGE - Overlaycopy ply overlay_name1x to y . . . overlay_nameNx to y Explanation: img_name identifies the Xerox IMG file. pseg_name identifies the AFP page segment. x and y are numeric values. x represents the horizontal coordinate. y represents the vertical coordinate. InfoPrint XT indicates whether it automatically prints the graphic on each page.
IRESULT - 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. JDE - A DJDE referenced Job Descriptor Entry jde_name. Explanation: The name of the JDE in use, which is jde_name. JDL - The left margin will be position_count positions.
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. RPAGE - The current logical page will move to the front | back of a new sheet.
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. SHIFT - The data stream converter will ignore SHIFT DJDEs. Explanation: The data stream converter found a SHIFT DJDE, but the conversion parameters include xhonorshift=no. xhonorshift=no is the default.
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. | Explanation: Specifies that the data stream converter | found an XSHIFT=NO DJDE, which prevents the | output from shifting in the directions specified.
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.
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.
This publication also documents intended Programming Interfaces that allow the customer to write programs to obtain the services of InfoPrint XT. This information is identified where it occurs, either by an introductory statement to a chapter or section, or by this marking: + — — — — — — — – — - Programming Interface information — — — — — — – — — + + — — — — — – — End of Programming Interface information — — — — — - — - + Trademarks These terms are trademarks or registered trademarks of Ricoh Co., Ltd.
158 InfoPrint XT Guide
Glossary of selected InfoPrint Solutions Company terms This glossary provides definitions of specialized terms that are used with InfoPrint XT for Windows (InfoPrint XT) and InfoPrint XT for Windows (InfoPrint Manager). This glossary does not include terms that non-technical dictionaries define, or that have no special meaning in information processing and printing. | | | | | | A Access Control List (ACL). In computer security, a collection of all access rights for one object. ACL. Access Control List.
D | | | | 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. (3) A continuous stream of data elements in transmission, or intended for transmission, in character or binary-digit form that use a defined format.
G | | | 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).
N 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. | | | | logical page. Synonymous with page. logical printer. In InfoPrint Manager, a type of logical destination.
| | 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. P | | | | page. (1) In AFP, a data stream object delimited by a Begin Page structured field and an End Page structured field. A page can contain presentation data such as text, image, graphics, and bar code data. (2) A collection of data that can print on a physical sheet of paper.
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. Using resources groups, you can load several versions of Xerox resources that have the same names, but different internal characteristics.
advances in networking server capability, parallel processing, and object-oriented programming.
166 InfoPrint XT Guide
Glossary of selected Xerox terms C 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. Then, the operator can run all the commands in the CMD file by entering its name as a single command, rather than having to enter all the commands individually. CME. Copy Modification Entry. Copy Modification Entry (CME).
G 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. H 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. The printer software (microcode) included with the Xerox LPS printer includes a printer-resident version of the software.
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. RAUX Pulls a single sheet of paper from the auxiliary paper tray. RDELETE Deletes specified records from offline data to prevent them from printing. RFEED Dynamically specifies a cluster of input paper drawers.
strings defined by the RSTACK or BANNER command serve to separate the reports. resource. See non-printable resource and printable resource. S 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. START. The command that a Xerox printer operator enters to start a print job from the console of a Xerox LPS printer.
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. Note: You can access viewable copies of many publications through the InfoPrint Solutions Company Web site: http://www.infoprint.
InfoPrint Solutions Company printers | v v v v v 172 InfoPrint XT Guide InfoPrint InfoPrint InfoPrint InfoPrint InfoPrint 2190, 2210, & 2235 Printers (MT 2707): Planning Guide, G550-0952 2060ES/2075ES/2090ES/2105ES: Finishing Guide for Printing, S544-5845 40 Infoprint 32: User’s Guide, S544-5484 70: Introduction and Planning Guide, GA18-7726 70 Plus: Introduction and Planning Guide, G544-5869
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 d
attributes, InfoPrint Manager for Windows (continued) job (continued) results-profile 70, 76 conversion parameters for Xerox jobs (continued) xckdupnlimg 95 xclb 95 xcmt2nop 95 xconvert 51, 95 xcopies 95 xcsmmname 34, 96 xhonorfcb2 96 xhonorinvert 96 xhonorshift 6, 96 xhonorstaple 7, 66, 96 xinlr 96 xinvertalign 97 xjde 24, 97 xjdl 24, 97 xlinecount 97 xlrecl 98 xmicrfont 98 xpaper 98 xpattern_set 99 xpcctest 99 xrecfm 100 xrptfile 100 xshading 100 xspacing 101 xstaplemax 7, 66, 102 xstapleorient 7, 66, 10
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 genera
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 pdxt-2.1.0.nn.exe 18 pdxtcapt.job 92 pdxtcapt.res 92 pdxtdownload.*.extension 81 pdxtdownload.portnumber.log 79 pdxtdownload.directives 78 pdxtdownload.
JCL parameters (continued) SEGMENT 71 TITLE 71 TRC 71 UCS 71 jes3211 carriage-control processing, enabling job-comment attribute 74 job-hold attribute 83 job-name attribute 70 job-state-reasons attribute 85 jobattr.
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.
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 jobs on tape 8 manual font correlations 6 OTEXT message display 6 pdxtdownload program 81 pdxtloadres -c 5 resolution for Xerox scan and dot directions 94 resources on tape 8 SHIFT command, Xerox 6, 96 spaci
U 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 user-id-text attribute 71, 81 16 V variable data directory, changing 22 version determining InfoPrint XT 91 operating system, Windows 11 printer driver software, InfoPrint XT for Windows UNIX emulation tools, Microsoft SFU 11 SUA 11 vert
Program Number: 5799-RZA Printed in USA GLD0-0025-01
