Ricoh INFOPRINT XT GLD0-0025-01 User Manual

InfoPrint XT for Windows: Installation Gui de and User’s Gui d e Ve r s i o n 2 Release 1 GLD0-0025-01

viii InfoPrint XT Guide

Note: InfoPrint XT only includes a 5016-707 message, which lists the contents of the pdxtdownload.port.att file, if pdpr errors occ

Temporary files pdxtdownload uses several temporary files. The temporary files are in the directory for the MVS Download receiver. Th

82 InfoPrint XT Guide

Chapter 7. Troubleshooting InfoPrint XT This chapter describes how to diagnose and correct problems when you transform Xerox jobs wit

pdpr -p ldest -x job-hold=true drive:\path\jobname Note: An incorrect document format value can also result in no printed output.Did

to convert the job. When it cannot complete the conversion, InfoPrint Manager changes the status of the job to held and does not

Note: InfoPrint Manager sets the job state to pending for a job that you submit when the actual destination is disabled. You can

Note: The C:\Program Files\IBM\InfoPrint XT portion of the path is the default directory in which the InfoPrint XT installation pro

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 t

Diagnostic and informational files that InfoPrint XT produces If InfoPrint XT cannot process the job, only a header page and an er

Tables 1. Printable Xerox resources and their AFP functional equivalents . . . . . . . . .2 2. Supported and unsupported PD

CLUSTRLIB=NONE XHONORFCB2=NO TWOPASS CAOBS MFDEF=F1AIOMFD XHONORSHIFT=NO XJES3211=YES XPATTERN_SET=300-1 XAFPFUNCTION=IO

variable fixed nfs Processing ended with return code 16 General error 7 occurred (errno 0) Service coordinator responsibilities It is yo

Using the pdxtcapture command After you place a service call, the technical-support representative might ask you to capture informatio

Appendix A. Conversion parameters for converting Xerox jobs Conversion parameters control how InfoPrint XT for Windows (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

it passes the type of carriage control it determined to its online (jes3211) carriage-control processing component. This can cause t

Descriptor Entry (JDE) or Dynamic Job Descriptor Entry (DJDE) COPIES option. If you do not specify this parameter, either the DJDE

all InfoPrint XT embeds all AFP character sets, code pages, coded fonts, overlays, and page segments that the job requires in the

[xlrecl=80 | nnnnn] Specifies the record length of the records in the job. If you specify a corresponding xrecfm=fixed parameter, t

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

x 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 t

Do not include the brackets in the value; the brackets indicate each position in the value is optional. Include the colons (:) be

Note: The xspcrmi conversion parameter does not control how InfoPrint XT interprets spacing characters in Xerox fonts that you have

for problem analysis. If you do not specify this parameter, InfoPrint XT does not capture trace information. Use this parameter onl

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

parse the value of that environment variable. The most likely cause is a problem with the content of the variable. For example, it

on a separate line. Or, the resources might not exist in the path explicitly specified in the file. You must specify a full path

5016-205 File file is empty. Explanation: The file identified in the message exists, but it does not contain any data. System acti

provides additional information about why the change action failed. System action: InfoPrint XT cannot process the request. User respo

About this publication This publication describes how to install, configure, and use InfoPrint® XT for Windows (InfoPrint XT). With In

5016-283 An error occurred while reading from command command (ReturnCode). ...msg Explanation: InfoPrint XT cannot read the output

5016-501 Date_Time (pid ProcessID) - transform started. Explanation: InfoPrint XT started to convert the Xerox job to AFP. System act

User response: Use the information from the error report to correct the problem. Then, submit the job again. 5016-600 Resource load

User response: Use the return code to determine why the correlation process failed and correct the problem. Then, load the resourc

Table 11. Return code numbers 1-64 in InfoPrint XT messages Error Symbolic constant and explanation Error Symbolic constant and expl

Table 12. Return code numbers 65-127 in InfoPrint XT messages Error Symbolic constant and explanation Error Symbolic constant and ex

116 InfoPrint XT Guide

Appendix C. Resource converter messages: 5018-nnn This section lists the messages that InfoPrint XT for Windows (InfoPrint XT) can is

5018-818 The image converter did not recognize the internal format of resource resourcename. Explanation: The image converter found a

5018-826 The image converter did not recognize scan orientation transformation input value inputvalue in resource resourcename. Explanati

Chapter 6, “Transferring jobs with Download for z/OS,” on page 67 Describes how to set up Download for z/OS to work with InfoPrin

5018-837 Resource resourcename specifies a maximum sample value of samplevalue. Explanation: InfoPrint XT supports a maximum sample va

Appendix D. Resource utility messages and data stream converter messages: AIOxxxnnnx This section lists the messages that the InfoPrin

the user that the resource utility found a possible problem in the input resource. However, the resource or resources processed suc

Explanation: The parameter parser found extraneous data among the keywords. System action: InfoPrint XT cannot process the request.

AIOxxx230I Processing Correlation Source File... Explanation: This is an informational message that indicates that InfoPrint XT is re

AIOxxx238I The correlation source processor did not create the table_name correlation table. Explanation: InfoPrint XT found no valid

AIOxxx247I The resource utility created no translation tables: Explanation: The translation source entries in the translation tables c

AIOxxx259S The resource utility found an inconsistency in Xerox resource filename.filetype: phase_name: error_info Explanation: The

User response: If you manually updated the correlation table, verify that the entry is correct and that the AFP resource exists.

System action: InfoPrint XT cannot process the request. User response: Correct the character and rerun the failing command. AIOxxx28

Understanding the syntax notation and the use of special characters These rules apply to the syntax diagrams and examples that this

AIOxxx299U Resource utility processing aborted due to unrecoverable errors. Explanation: This message occurs when the resource utility

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 requir

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

User response: If you are converting a Xerox job, make sure that the conversion parameters for the job are valid. See Appendix A

AIOxxx293I The data stream converter needs Xerox resource resource_name for this conversion. Explanation: InfoPrint XT did not find a

User response: Make sure that the xcc conversion parameter specifies the correct type of carriage control, and verify that the dat

file resource_list_name matches the information in overlay overlay_name. AIOxxx473E The data stream converter detected one or more missi

AIOxxx491E The transform detected an attempt to reshape graphic characters by using nongraphic Xerox font font_name on page page_number

the COLLATE DJDE in the input file and reconvert the job. AIOxxx563W The data stream converter ignored an incorrect COLLATE change r

AIOxxx574W The data stream converter ignored page-oriented keywords in the DJDE packet on record number due to a prior page oriented

InfoPrint XT manual (man) pages An InfoPrint XT installation includes online help in the form of man pages. To see the InfoPrint X

User response: This is an informational message that requires no user response. AIOxxx610E A translation error occurred while process

failed because of insufficient memory. The image graphic uses the naming convention SGnnnnnn. nnnnnn is a number from 0 through 9999

AIOxxx712W XHONORSTAPLE is in effect, but reformatted JDL jdl_name/JDE jde_name does not include stapling information. The converter dis

InfoPrint XT created from a Xerox font, report this message to your technical support representative. AIOxxx766S The font processor c

AIOxxx773E A resource processor could not find cl_type cluster name cl_name in reformatted cluster database clb_name during processing

AIOxxx779E FEED command in DJDE packet ending on record record_number specified stock reference stk_ref, but no STOCKSET is in use; t

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

BFORM - No overlay will appear on the back of subsequent sheets. Explanation: A BFORM=NONE DJDE cancelled a previous BFORM DJDE. BO

FONTINDEX - The data stream converter will interpret data bytes at offset x as table reference characters, which number the fonts

Summary of changes These are brief descriptions of the functional updates to InfoPrint XT for Windows (InfoPrint XT) and the corresp

FORMS - The following overlays will appear on the front of subsequent sheets. Overlaycopy ply overlay_name1x to y ...overlay_nameNx to

IRESULT - The data stream converter does not support the IRESULT DJDE. Explanation: An IRESULT DJDE, which InfoPrint XT does not s

RFORM - Overlay overlay_name will appear on the front of routing text pages. Explanation: Specifies that the AFP overlay overlay_nam

SEFFNT - The data stream converter does not support the SEFFNT DJDE. Explanation: A SEFFNT DJDE, which InfoPrint XT does not suppo

XSHIFT - The data stream converter will ignore XSHIFT DJDEs. Explanation: The data stream converter found an XSHIFT DJDE, but the

Notices This information was developed for products and services offered in the U.S.A. InfoPrint Solutions Company may not offer the

InfoPrint Solutions Company may use or distribute any of the information you supply in any way it believes appropriate without incu

This publication also documents intended Programming Interfaces that allow the customer to write programs to obtain the services of

158 InfoPrint XT Guide

Glossary of selected InfoPrint Solutions Company terms This glossary provides definitions of specialized terms that are used with Info

the job to further verify the type of carriage controls. If it detects a different type of carriage control, InfoPrint XT override

D data stream. (1) The commands, control codes, data, or structured fields that are transmitted between an application program and a

G graphics. (1) Charts, pictures, illustrations, and tables created from fundamental drawing units such as lines, curves, and polygons

maps the job to the user who submitted it. InfoPrint Manager maps a local job ID to a global job ID. logical destination. In In

their own environment and are often used as electronic forms. (2) A collection of predefined static data, such as lines, shading, t

reformatted Xerox resource path. Synonymous with metrics directory. resource group. In InfoPrint XT, resource files that are in the

advances in networking server capability, parallel processing, and object-oriented programming. Glossary of selected InfoPrint Solutions

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-langu

G GHO. Graphics Handling Option. Graphics Handling Option (GHO). A collection of hardware and software that enables a Xerox LPS prin

information about the banner pages for accounting purposes, or it might delimit reports in a print job. BDELETE Deletes specified bloc

v The -b option for the pdxtloadres command on page 42 v The xspcrmi conversion parameter on page 101Enhancements to Xerox sha

strings defined by the RSTACK or BANNER command serve to separate the reports. resource. See non-printable resource and printable res

Bibliography You can find additional information about products that you can use with InfoPrint XT for Windows (InfoPrint XT) in the

InfoPrint Solutions Company printers v InfoPrint 2190, 2210, & 2235 Printers (MT 2707): Planning Guide, G550-0952 v InfoPrint

Index Special characters%PDXTINSTDIR%,definition 13 permanently removing 19 %PDXTINSTDIR%\testjob directory 16, 26 %PDXTWORKDIR%definition 13

attributes, InfoPrint Manager for Windows (continued)job (continued)results-profile 70, 76 BBegin Image Object (BIM) structured field 33

directories (continued)%PDXTWORKDIR%\resources\common\pdxtloadres 41 %PDXTWORKDIR%\resources\common\xrxres 38 C:\OtherDirectory 37 C:\OtherDirecto

FILE DJDE support (continued)processing limitations, concurrent jobs 4, 66 resource-load directory 61 file name conventions, pdxtdownload

JCL parameters (continued)SEGMENT 71 TITLE 71 TRC 71 UCS 71 jes3211 carriage-control processing, enabling 29 job-comment attribute 74 job-

PDXT_WINPATH2UNIX environment variable 22 PDXT_XR2FAPI_TRACE environment variable 24 PDXT_XR2IAPI_TRACE environment variable 24 pdxt-2.1..0.n

restrictions, InfoPrint XT240-pel printer support 8 accounting limitations 4 AFP DBCS fonts, FOCA conformance 8 channel connections 8 co

For information about the xhonorshift conversion parameter, see page 96. Generation of NOP structured fields for C DJDE text Mixed O

Uunderscores, syntax diagrams xiii uninstalling InfoPrint XT 19 UNIX emulation tools, MicrosoftSFU 11 SUA 11 UNKNOWNjob ID value 21, 63

Program Number: 5799-RZA Printed in USA GLD0-0025-01

Chapter 1. Introducing InfoPrint XT This chapter briefly describes the components of InfoPrint XT for Windows (InfoPrint XT), how it

XT load process. The InfoPrint XT pdxtloadres command does the actual conversion. You also convert the non-printable resources. Printa

v “InfoPrint XT resource utility messages” on page 121Non-printable Xerox resources that InfoPrint XT does not use The other types

Methods of sending jobs to the Windows system and submitting them to InfoPrint XT You can use these methods to send Xerox LCDS an

Grayscale substitution for Xerox shading InfoPrint XT can interpret and convert Xerox shading patterns and characters to grayscale. Th

Highlight-color job processing You can submit Xerox jobs that contain color-related metacodes or PDL commands, such as ICATALOG, IDR,

code points. This function does not correct any other type of code page conflicts that occur after manually correlating Xerox resou

Note: For more information about the xhonorstaple, xstapleorient, xstaplesysgen, and xstaplemax parameters, see Appendix A, “Conversion

Table 2. Supported and unsupported PDL and DJDE commands (continued) Supported Unsupported ¹ BFORM DESTINATION BOF EXPAGE C EXPORT CANCE

InfoPrint XT for Windows: Installation Gui de and User’s Gui d e Ve r s i o n 2 Release 1 GLD0-0025-01

v ¹ InfoPrint XT ignores these commands when it finds them in a job. InfoPrint XT processes the job and issues informational me

Chapter 2. Installing and configuring InfoPrint XT This chapter describes how to install software, configure a base InfoPrint XT for

You can select Standard Installation when you install SFU. Also, consider enabling setuid behavior and case-sensitivity during install

5. You must complete other configuration tasks for combined InfoPrint Manager and InfoPrint XT installations. See “InfoPrint Manager

Creating the InfoPrint XT configurable transform Use the pdxtcrtxform command to create an InfoPrint XT configurable transform object

ETIMEDOUT The pdls command did not respond to a query. other Any other return codes that are not in this list are return codes f

Return codes from the pdxtsetdest command Return codes from the pdxtsetdest command are: 0 The command successfully updated the speci

4. Copy the parameter mapping file for the test job to the %PDXTWORKDIR% directory: copy pdxtx2afp.map C:\Program Files\IBM\Infoprint

Applying an InfoPrint XT product update When an InfoPrint XT update is available, you can install it on the system to run the lat

Rejecting an InfoPrint XT product update If you apply an InfoPrint XT update, and then want to return the Windows system to a pre

Note: Before using this information and the product it supports, read the information in “Notices” on page 155.Second edition (Devem

b. Select and delete the InfoPrint XT %PDXTWORKDIR% working directory. The default working directory is C:\Program Files\IBM\Infoprin

Chapter 3. Customizing InfoPrint XT This chapter describes how to customize InfoPrint XT for Windows (InfoPrint XT). All procedures i

Controlling the working directory that InfoPrint XT uses for variable data (PDXTWORKDIR) The PDXTWORKDIR environment variable controls

Table 3. DOS-to-UNIX directory conversions (continued) Command PDXT_WINPATH2UNIX setting Resulting directory pdxtloadres -n "/directory/

These are examples of values that you can enter in the Variable value field of the Windows System Properties interface: v To spe

also writes a line number from the module, which indicates the line at which the condition that caused the message occurred. The

Creating a custom parameter mapping file When you convert a Xerox job, you must specify certain parameters that equate to the Xerox

The parameters that you can assign are -g, -r, -t, and -x. These parameters correspond to a subset of the processing parameters t

Verifying the parameter specification of the mapping file When you convert a job, InfoPrint XT writes messages to the pdxtx2afp.log

Using transform directives InfoPrint XT provides a set of internal directives that you can activate to control certain aspects of th

Contents Figures . . . . . . . . . . . . . . vii Tables . . . . . . . . . . . . . . .ix About this publication . .

the Xerox input to, and the AFP output from the conversion process. You can also specify more than one value on a single occurre

#------------------------------------------------# # Capture and keep the Xexox input and the AFP # # output for all jobs with a de

Table 5. InfoPrint XT NOP structured field format (continued) Offset Length Value Description 1 2 8-32767 Total length of the struct

Bit 7: Reserved for future use.The CTLHEADR record has no associated data. A CTLHEADR record that indicates the possible presence

Bit 0: Reserved for future use. Bit 1: Reserved for future use. Bit 2: Reserved for future use. Bit 3: Reserved for future use. Bi

² Bins are numbered 1 through 255. For information about the xcsmmname conversion parameter, see page 96. Chapter 3. Customizing In

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 reso

v %PDXTWORKDIR%\resources\common\metrics v %PDXTWORKDIR%\resources\resgrp\metrics v C:\OtherDirectory\metricsXerox resource directory For

Table 8. Xerox resource extensions, AFP prefixes, and metrics extensions (continued) Xerox resource type and extension Resulting InfoP

Loading order for Xerox resources by resource type . . . . . . . . . . . . . . . .39 Information files generated by InfoPri

Information files generated by InfoPrint XT during resource tasks InfoPrint XT creates files in which it stores information about res

but do not enter a value for that option. This causes InfoPrint XT to use the information in the pdxtloadres.rty file to determin

Using the pdxtloadres command to load Xerox resources You use the InfoPrint XT pdxtloadres command to load all the Xerox resources

Presentation Text Object Content Architecture (PTOCA) text-string characters. This is the default. spcrmi InfoPrint XT interprets spacing

any position, InfoPrint XT uses the default percentage for LIGHT, MEDIUM, or HEAVY. These are examples of values you can specify: -c

Application programs that issue the pdxtloadres command can use these universal values instead of the language-specific keywords: v

2. If you are loading resources, you can specify Xerox resources with names that follow IBM Infoprint XT Extender for z/OS naming

v CMC7For example, InfoPrint XT generates AFP MICR fonts for these Xerox fonts: E13BPX.FNT, E14BL.FNT, CMC7J.FNT. xerox+font1:font2:fo

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.

If you specify the -o option, you cannot specify the -g option. If you do not specify either -o or -g, the pdxtloadres command

InfoPrint Solutions Company printers . . . . . 172 Index . . . . . . . . . . . . . . . 173 Contents v

fd2 (STDERR) The command writes messages to this stream.Return codes from the pdxtloadres command Return codes from the pdxtloadres c

You can use the pdxtx2afp command to create a preliminary list of the resources that a job requires. Before you scan the job, yo

not have to start at the same column location as the second keyword of another entry. You might want to use a specific columnar

Figure 3 shows the various types of entries that you can make in a manual font correlation table for single-byte Xerox fonts. C

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 mo

table that is in the C:\Program Files\IBM\Infoprint Manager\reslib directory. If you loaded the Xerox resources in the common resourc

replaces the contents of the existing file with the deblocked output. If you do not specify a file name, the command reads from

v If you use standard input to pass the Xerox resource, the command uses the default name dfault.jsl.Note: The pdxtblkres comman

58 InfoPrint XT Guide

Chapter 5. Submitting Xerox jobs for data stream conversion This chapter describes how to convert Xerox Line Conditioned Data Stream

vi InfoPrint XT Guide

command specifies, or the path to the resource group that the -g option specifies. See “Using the pdxtloadres command to load Xero

creates AFP versions of the Xerox resources. When you submit a Xerox job, those AFP versions of the Xerox resources must be avail

The syntax of the pdxtx2afp command is: pdxtx2afp [-i inputfile | -] [-o outputfile | -] [[-g common | group ]|[-r resou

class=n Specifies the class for the job. This corresponds to the CLASS parameter that you specify if you submit the job with job c

successfully. If you do not specify this command option, InfoPrint XT uses a subdirectory of the directory that the PDXTWORKDIR envi

other Any other return codes that are not in this list are return codes from C functions. See “Return code numbers” on page 113

There might be occasions when you want to embed some or all the permanent resources inline with the AFP data stream for the job.

Chapter 6. Transferring jobs with Download for z/OS This chapter describes how to set up and use Download for z/OS to submit Xero

externally. For example, you can use an attribute mapping file to set the attributes based on the characteristics of the job. See

Creating InfoPrint Manager MVS Download receivers When you create an InfoPrint Manager MVS Download receiver through the InfoPrint Man

Figures 1. InfoPrint XT test page . . . . . . . . .18 2. Completed parameter mapping file . . . .28 3. Sample correlation

Using JCL parameters to assign InfoPrint Manager attributes When an MVS Download receiver receives a data set and calls the pdxtdow

Table 10. InfoPrint Manager attribute assignments when using the pdxtdownload program (continued) Node ID -ono node-id-text OFFSETXB -oo

a job matches the criteria, InfoPrint XT assigns the attribute-and-value pairs that follow the expression to the job. When you edit

You can also use substitute values from the MVS Download receiver options in expressions. A substitute value is a keyword that you

v You must install Print Parameters Exit 15 on z/OS. This causes the output writer to include sequence information with the data

nosubmit Does not submit jobs to InfoPrint Manager.Note: Use this download directive only at the direction of a technical support r

single job that contains one document for each copy of each data set. Use this directive for data sets that contain data streams

addskip=none pdxtdownload does not add skip-to-channel-one carriage controls. This is the default. addskip=multi pdxtdownload adds skip-to-

pdxtdownload passes both the destination-name-requested attribute and the initial-value-document attribute. attr pdxtdownload uses the ent

[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.