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