Conversion parameters for converting Xerox jobs

Infoprint XT uses transform conversion parameters to set up the starting environment when it converts a Xerox job. Through a subset of the parameters, you specify the same information that a Xerox printer would receive through the START command for the job. Other parameters control how Infoprint XT actually processes the job. Infoprint XT provides a number of methods through which you can specify the conversion parameters:

You can use the following ways to specify transform conversion parameters, for all job-submission methods. These apply whether you batch-process jobs through job control language, process jobs in either of the Infoprint Server environments, or process jobs from the command line.
- With the PDXTX2AFP_ARGS environment variable. You can use this to set your own default values. See Controlling the default arguments when you process jobs (PDXTX2AFP_ARGS).
- In the transform mapping file. You can also use this to set your own default values. See Creating a custom parameter mapping file.
If you only batch process jobs and use the AIOZ2AFP utility program, you can specify conversion parameters through the SYSIN data definition (DD) statement, or the EXEC DD statement when you use JCL to invoke the AIOZ2AFP utility program for job conversion. See JCL statements for AIOZ2AFP.
If you have Infoprint Server installed, you can specify the parameters when you:
- Modify your JCL and use the Infoprint Server Print Interface subsystem. See Modifying the application JCL and including conversion parameters.
- Create printer definitions. If you use the Print Interface subsystem, you can specify conversion parameters in the PSF for z/OS printer definition. See Creating printer definitions that specify the Infoprint XT transform filter. If you use IP PrintWay, you can specify the parameters in the IP PrintWay printer definition. See Creating an IP PrintWay printer definition.
If you have the need to process jobs from the command line with the pdxtx2afp command, you can use the -x command option. You issue the pdxtx2afp command in the UNIX System Services environment. See Using the pdxtx2afp command to process jobs.

This list describes the conversion parameters for Xerox jobs:

xaccount = yes | no

Specifies whether Infoprint XT prints a Xerox-style accounting page for the job. The default is that Infoprint XT prints the accounting page.

Note: There can be occasions when you request the accounting page, but no accounting page prints with the job. If the job does not produce an accounting page on a Xerox printer, Infoprint XT does not produce an accounting page regardless of the presence of this parameter.

xafpfunction = ioca_rt | no_ioca_rt

Specifies whether the printer supports the IOCA replicate-and-trim function. Infoprint XT uses this function for the shading patterns in data streams and forms. The default is that Infoprint XT assumes the printer supports the IOCA replicate-and-trim function.

Notes:

If one or more of your printers do not support the IOCA replicate-and-trim function, specify no_ioca_rt for the xafpfunction parameter.
The value of this attribute affects how Infoprint XT processes jobs that contain FILE DJDE commands.
If you are using Infoprint Server's afpxps, afpxpdf, or afpxpcl transform to transform the AFP output of the Infoprint XT, specify a value of no_ioca_rt.

xafprc = 12 | 0 through 16

Specifies the largest return code that lets Infoprint XT generate AFP output. If you do not specify this parameter, the default is 12. Infoprint XT does not generate any AFP when the return code is greater than the value of this parameter.

xalign = 0 | scan_value| :dot_value | scan_value:dot_value

Controls how Infoprint XT aligns the AFP output with the pages of the job. The value range for scan_value is -100 through 300 pels. The value range for dot_value is -300 through 1500 pels. If you only specify dot_value, precede it with a colon (:). If you specify both scan_value and dot_value, separate them with a colon. Scan and dot values have these effects:

A positive scan value moves the page image to the right in the portrait orientation, or down in the landscape orientation.
A negative scan value moves the page image to the left in the portrait orientation, or up in the landscape orientation.
A positive dot value moves the page image up in the portrait orientation, or to the right in the landscape orientation.
A negative dot value moves the page image down in the portrait orientation, or to the left in the landscape orientation.

If you do not specify the xalign conversion parameter, the default is 0 for both the scan value and the dot value. If you specify the xalign conversion parameter but omit either the scan value or the dot value, Infoprint XT uses a default of 0 for the omitted value.

Notes:

Infoprint XT only supports values for the Xerox scan and dot directions in 300 dots-per-inch (dpi) resolution. It does not support values in 600 dpi resolution.
Infoprint XT does not support the TEST parameter of the Xerox ALIGN command.
See xhonorinvert transform conversion parameter and xinvertalign transform conversion parameter. These parameters affect how Infoprint XT aligns inverted output.

xbinerror = ignore | stop | continue

The xbinerror parameter controls printing when the wrong media is loaded on the printer.

The xbinerror parameter has these options:

ignore: Infoprint XT does not include a media error instruction in the inline form definition. This is the default.
stop: Infoprint XT includes a media error instruction in the inline form definition. If the specified input media is not found when the job is printed, printing stops and the job is held in a state that it can be resubmitted from.
continue: Infoprint XT includes a media error instruction in the inline form definition. If the specified input media is not found when the job is printed, printing continues by using the printer default input media.

xcc = ansi | machine | none

Specifies the type of carriage controls that are present in the data, or specifies that no carriage controls exist. If you do not specify this parameter, Infoprint XT expects American National Standards Institute (ANSI) carriage controls.

Notes:

Infoprint XT only uses the value that you specify for this parameter, or the default value, when you manually convert jobs with the pdxtx2afp command. See Using the pdxtx2afp command to process jobs. For all other job submission methods, Infoprint XT derives the carriage-control value from the attributes of the input data set.
If you convert a job by using Infoprint Server Print Interface subsystem with Infoprint XT, and the job contains carriage controls, you must use the DCB parameter. The record format specified by that parameter identifies the type of carriage controls that Infoprint XT expects in the job. For example, if the Xerox data is fixed-block, ANSI, you would specify:
```
DCB=(RECFM=FBA)
```
There is a wide variety of record formats that you can specify. See the JCL documentation for the values that you can specify.

xckdupnlimg = yes | no

Specifies whether Infoprint XT checks inline images to prevent duplicate image processing when it converts online jobs. When you specify xckdupnlimg=yes, Infoprint XT can reduce its execution time for jobs that contain many duplicate inline images. The default is xckdupnlimg=no.

Notes:

This conversion parameter only applies to inline images that GRAPHIC DJDEs specify. It does not apply to inline images that IMAGE DJDEs specify.
xckdupnlimg does not apply to offline jobs.

xclb = clustr | clusterlib_name | none

Specifies the name of the cluster database in use, or specifies that no cluster database is in use. If you do not specify this parameter, the default is clustr for the cluster database name.

Notes:

If the job uses stocksets and you print the job on a continuous-forms printer, specify xclb=none. This causes Infoprint XT to ignore stock references. Specifying a paper drawer has no meaning when the job prints on a continuous-forms printer.
The clustr.lib file can specify both a preferred tray and a current tray for a specific cluster name. If a cluster name specifies both a preferred tray and a current tray, Infoprint XT uses the value for the current tray. This matches the operation of a Xerox printer.
The pdxtcluster command can help you customize your Xerox cluster databases. See Using the pdxtcluster command to create and modify cluster database resources.

xcmt2nop = yes | no

Specifies whether Infoprint XT generates No Operation (NOP) structured fields for the text of C DJDEs in the job. If you specify xcmt2nop=yes, Infoprint XT includes all C DJDE text for a Xerox input page in the corresponding page of the AFP output. The default is xcmt2nop=no. See the information about the XRXCDJDE keyword in Infoprint XT AIOX2AFP NOP keywords.

Notes:

The C DJDE is record-oriented and takes effect on the next record that follows the next END; DJDE packet terminator. If a C DJDE occurs in a packet that contains one or more page-oriented DJDEs, Infoprint XT associates the AFP NOP that it creates from the C DJDE with the page on which the DJDE occurs. It does not associate the AFP NOP with the page on which the page-oriented DJDEs in the packet take effect.
Each C DJDE text string that is processed by xcmt2nop=yes must be all ASCII or all EBCDIC alphanumeric or blank characters, and must not contain any special characters.

xconsecutivedjde = ignore | process

Specifies whether Infoprint XT ignores or processes consecutive DJDEs.

ignore: Infoprint XT ignores extra DJDE records directly following a previously terminated DJDE packet. This is the default.
process: Infoprint XT processes extra DJDE records directly following a previously terminated DJDE packet.

xconvert = yes | no

Specifies whether Infoprint XT converts the job and produces AFP output. You can specify xconvert=no with the pdxtx2afp command, or you can specify it in the JCL that you use to run the AIOZ2AFP utility program. If you specify xconvert=no, Infoprint XT lists the resources that the job requires. If you use the pdxtx2afp command, Infoprint XT writes the list of required resources to STDERR. If you use JCL, the SYSPRINT data set contains the list of resources. By default, Infoprint XT converts the job, and produces AFP output.

Note: You must load the JDL for the job before you can scan a job for the other resources that it requires. You must also load all of the fonts that the starting JDL and JDE pair specify.

xcopies = nnnnn

Specifies the starting value for the number of copies. nnnnn is an integer from 1 through 32767. This parameter provides compatibility with the Xerox START command. If you specify this parameter and value, it overrides the number of copies for each file as requested by the Job 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. If you specify yes as the value of this conversion parameter, Infoprint XT creates medium map names in a format that describes the contents of the medium map. For information about the format that Infoprint XT uses for content-sensitive medium map names, see Working with content-sensitive medium map names.

xdeblock = yes | no

Specifies whether Infoprint XT deblocks records in offline jobs during conversion, based on the starting JDE. If you do not specify this parameter, Infoprint XT does not deblock records.

xdecrypt = auto | all | none

Controls font decryption during data stream conversion when Infoprint XT loads Xerox fonts that FILE DJDEs identify. You can use one of these values:

auto: Infoprint XT automatically determines whether each font that it loads from a FILE DJDE command requires decryption. This is the default
all: Infoprint XT runs its decryption utility for every font that it loads from a FILE DJDE command. You can use this option to force Infoprint XT to decrypt fonts when it cannot automatically detect that the fonts are encrypted.
none: Infoprint XT does not run its decryption utility for any of the fonts that it loads from a FILE DJDE command. You can use this option to prevent Infoprint XT from attempting to decrypt when it cannot automatically detect that the fonts are not encrypted.

xhonorcolor = yes | no

Specifies whether Infoprint XT accepts Xerox highlight color commands during data stream conversion.

yes: Infoprint XT processes highlight color commands that it finds in the job data stream.
no: Infoprint XT does not process highlight color commands. This is the default.

xhonorfcb2 = yes | no

Specifies whether Infoprint XT accepts Forms Control Buffers (FCBs) specified by the JDL or JDLs for the job. If you specify xhonorfcb2=yes and the JDL specifies FCB=PROCESS, Infoprint XT processes FCBs that it finds in the job data stream. If the JDL specifies FCB=IGNORE, Infoprint XT ignores the FCBs. If you specify xhonorfcb2=no, or if you omit this parameter, Infoprint XT does not process FCBs, regardless of whether the JDL specifies FCB=PROCESS or FCB=IGNORE.

xhonorinvert = yes | no

Specifies whether Infoprint XT accepts INVERT commands that JDLs or DJDEs for the job specify. If you specify xhonorinvert=yes, Infoprint XT processes INVERT commands that it finds in the job data stream. If you specify xhonorinvert=no, Infoprint XT does not process INVERT commands. If you do not specify this parameter, the default is no.

Note: See xalign transform conversion parameter and xinvertalign transform conversion parameter. If you specify xhonorinvert=no or xinvertalign=no, Infoprint XT aligns all output pages in the same direction.

xhonorshift = yes | no

Specifies whether Infoprint XT accepts SHIFT and XSHIFT commands that JDLs or DJDEs specify for the job. If you specify xhonorshift=yes, Infoprint XT processes SHIFT and XSHIFT commands that it finds in the job data stream. If you specify xhonorshift=no, Infoprint XT does not process SHIFT or XSHIFT commands. If you do not specify this parameter, the default is no. Restrictions apply when you use xhonorshift=yes. See SHIFT and XSHIFT JDL and DJDE commands.

xhonorstaple = yes | no

Specifies whether Infoprint XT accepts FACEUP, NTO1, and STAPLE commands, which are subparameters of the OUTPUT PDL command. These commands control how the printer hardware staples the reports in the job. The default is that Infoprint XT ignores stapling commands. See the descriptions of xstaplemax transform conversion parameter, xstapleorient transform conversion parameter, and xstaplesysgen transform conversion parameter. See Stapling support for information about stapling restrictions.

xinlr = all:cs:cp:cf:pseg:ovly:inlr

Specifies the printable AFP resources that Infoprint XT embeds inline in the AFP data stream for the job. You can specify one or more values. If you specify more than one value, separate the values with colons ( : ). Do not include any spaces. Valid values are:

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.
pseg: Infoprint XT embeds all AFP page segments that the job requires in the AFP data stream.
ovly: Infoprint XT embeds all AFP overlays that the job requires in the AFP data stream.
inlr: Infoprint XT embeds the resources that it loaded from the Xerox job, as directed by the FILE DJDE commands that the job contains. This includes both permanent and temporary resources, as defined by the storage parameter.
The default is that Infoprint XT only embeds temporary resources that it loaded through FILE DJDE commands with the D storage parameter.

By default, Infoprint XT does not imbed any permanent resources inline in the AFP data stream. If you include the xinlr parameter without a value, Infoprint XT issues an error message. See Processing jobs that contain FILE DJDE commands for detailed information about how Infoprint XT processes FILE DJDE commands.

xinvertalign = no | yes

Controls how Infoprint XT aligns the AFP output with pages that are inverted by the Xerox OUTPUT INVERT command or INVERT DJDE. xhonorinvert=yes must be set for the job.

If you specify xinvertalign=yes, scan and dot values that you specify with the xalign conversion parameter align output on the inverted pages in the opposite direction as the alignment of non-inverted pages. For example, if you specify xalign=0:-56 for a job that is in the landscape orientation, non-inverted pages are aligned 56 dots to the left, and inverted pages are aligned 56 dots to the right.

If you specify xinvertalign=no or omit the xinvertalign conversion parameter, Infoprint XT aligns all output pages in the same direction. This is also true if you specify xhonorinvert=no.

Note: See xalign transform conversion parameter and xhonorinvert transform conversion parameter.

xjde = dflt | jde_name

Specifies the name of the Xerox JDE that the operator starts on the Xerox printer before the job prints. If you do not specify this parameter, the default is dflt.

xjdl = dfault | jdl_name

Specifies the Xerox JDL that contains the starting JDE. If you do not specify this parameter, the default is dfault.

xlinecount = n

Specifies the maximum number of lines per page for jobs that have no explicit page breaks, as defined through the Job Entry Subsystem (JES) line spacing parameter.

xlrecl = 80 | nnnnn

Specifies the record length of the records in the job. If you specify the xrecfm=fixed parameter, the valid range is 1 through 32760. If you do not specify the xlrecl parameter with the xrecfm=fixed parameter, the default is 80.

If you specify xrecfm=variable, the valid range is 1 through 32756. However, Infoprint XT derives the record length from the 2-byte length field at the beginning of each record and does not use the xlrecl value.

xmediatypes = none | blank_sub:type1:type2:type3:type4

Specifies Xerox input tray numbers that are associated with MO:DCA media types or component IDs. Infoprint XT includes the media types or component IDs in the medium maps of the inline form definition that Infoprint XT creates during data stream conversion. The values are:

none: Infoprint XT does not specify media types in the inline form definition. This is the default.
blank_sub:type1:type2:type3:type4: Infoprint XT specifies MO:DCA media types in the inline form definition that it creates.

These are the usage guidelines for the MO:DCA media types:

You can specify up to four media type identifiers. The identifiers can be media names or component IDs.
Media names must be from 1 to 12 bytes long. Infoprint XT validates media names by using a subset of IBM® code page 500, character set 640 (plus space character). This subset includes:
- uppercase A-Z
- lowercase a-z
- 0 – 9
- blank
- period (.)
- special characters @ % * - _ = + , / ?
Media names that you specify in the xmediatypes parameter should not contain single quotation marks or double quotation marks. Media names cannot contain colons because colons are used to delimit media type values in the parameter.
If a media name contains embedded blanks, you must replace the blanks with the character you specify as the blank_sub value. The blank_sub value can be any of these special characters: @ % * - _ = + , / ?
If you omit the blank_sub value, the default is the underscore character (_). Infoprint XT internally converts all occurrences of the blank_sub value in media names to blanks. For example, if the blank_sub value is the underscore character, Infoprint XT matches ‘210x340_MED’ to the registered MO:DCA media name ‘210x340 MED’.
Media names are case-sensitive. For example, if you specify the underscore character as the blank_sub value, Infoprint XT recognizes ‘210x340_MED’ as the registered MO:DCA media name ‘210x340 MED’, but it processes ‘210x340_med’ as user-defined, non-registered media name ‘210x340 med’.
Component IDs must be integers in the range 0 – 268,435,455. Infoprint XT assumes that non-numeric media types are media names.
If you enclose a numeric media type in braces, { }, Infoprint XT interprets the numeric value as a media type name, rather than as a component ID. Numeric media type names enclosed in braces must be from 1 to 12 bytes long.
Separate the media type identifiers with colons. The identifiers are positional: Infoprint XT substitutes type1 for tray 1, type2 for tray 2, and so on. If you omit any of the media type identifiers, Infoprint XT uses the tray number instead.
Infoprint XT searches the MO:DCA media types registry for entries that match the media names or component IDs that you specify. Infoprint XT processes any media names or component IDs that are not found in the registry as user-defined.
You can specify the xmediatypes parameter twice in one pdxtx2afp command, for a total of eight media type identifiers.

These are examples of values you can specify:

xmediatypes=@:ISO@A4:50::MY@MEDIA
xmediatypes=*:8x13*MED:13000:LEDGER

Xerox tray numbers	Media type substitutions in AFP output
1	Registered MO:DCA media name ‘ISO A4’ (component ID 0)
2	Registered MO:DCA component ID 50 (media name LETTER)
3	Tray 3, no substitution
4	User defined media name ‘MY MEDIA’
5	Registered MO:DCA media name ‘8x13 MED’ (component ID 163)
6	User defined component ID 13000
7	Registered MO:DCA media name LEDGER (component ID 67)
8	Tray 8, no substitution

xmediatypes=-:BLUE-MED:GREEN-STOCK:LETTER
xmediatypes=:MY_PAPER:{65432}:8x13_MED:69

Xerox tray numbers	Media type substitutions in AFP output
1	User defined media name ‘BLUE MED’
2	User defined media name ‘GREEN STOCK'
3	Registered MO:DCA media name LETTER (component ID 50)
4	Tray 4, no substitution
5	User defined media name 'MY PAPER'
6	User defined media name '65432'
7	Registered MO:DCA media name ‘8x13 MED’ (component ID 163)
8	Registered MO:DCA component ID 69 (media name STATEMNT)

Specifies whether Infoprint XT generates AFP magnetic ink character recognition (MICR) fonts when it loads Xerox fonts that FILE DJDEs identify. You can use one of these values:

none

Infoprint XT does not generate AFP MICR fonts for any of the Xerox fonts that it loads from FILE DJDE commands. This is the default.

all

Infoprint XT generates AFP MICR fonts for all the Xerox fonts that it loads from FILE DJDE commands in the job.

xerox

Infoprint XT generates AFP MICR fonts for all Xerox fonts whose names begin with these standard prefixes for MICR font names:

E13B
E14B
CMC7

For example, Infoprint XT generates AFP MICR fonts for these Xerox fonts: E13BPX.FNT, E14BL.FNT, CMC7J.FNT.

xerox+font1:font2:font3

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 three fonts that you specify by name. Separate the font names with colons ( : ). The fonts you specify can be any Xerox fonts.

xerox-font1:font2:font3

Infoprint XT generates AFP MICR fonts for all Xerox fonts whose names begin with E13B, E14B, or CMC7 except for the fonts you specify after the minus sign (-). You can specify up to three Xerox fonts that begin with the standard prefixes for MICR font names. Separate the font names with colons.

font1:font2:font3

Infoprint XT generates AFP MICR fonts for the Xerox fonts you specify. You can specify up to three fonts. Separate the font names with colons. The fonts you specify can be any Xerox fonts. Infoprint XT does not generate AFP MICR fonts for any Xerox fonts that begin with the standard prefixes for MICR font names unless you specify them in the list of fonts.

Note: To name more than three fonts, you can specify more than one xmicrfont conversion parameter, up to 11 occurrences that specify a combined total of 33 fonts. Values for all occurrences of the conversion parameter must be of the same type, either xerox+, xerox-, or user-specified names.

xpaper = letter | legal | ledger | folio | A3 | A4 | A4LT | B4

Specifies the paper size for jobs that specify inline forms through FILE 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. If you do not specify this parameter, Infoprint XT uses a default of letter when it processes FILE DJDE jobs that do not explicitly specify paper sizes.

Notes:

A4LT is a custom paper size that is 8.5 inches by 11.69 inches, or 216 mm by 297 mm.
The value of this attribute affects how Infoprint XT processes jobs that contain FILE DJDE commands.

xpattern_set = 300-1 | 300-2

Specifies the type of shading patterns that Infoprint XT uses when it processes Xerox FORMS$, FORMSX, and ISISPX fonts during metacode data-stream conversion. The default 300-1 specifies the shading patterns that Xerox 97xx, 4x50, and 4x90 printers use. 300-2 specifies the patterns that Xerox 4x35 printers use.

Note: The value of this attribute affects how Infoprint XT processes jobs that contain FILE DJDE commands.

xpcctest = yes | no

Specifies whether Infoprint XT automatically tests the online Xerox data stream to verify whether the carriage controls are ANSI or machine code. Infoprint XT passes the type of carriage control to its online carriage-control processing component. It first looks at the value of the xcc conversion parameter. Then, if the value of the xpcctest conversion parameter is yes, it reads the first records of the job to further verify the type of carriage controls. If Infoprint XT determines that the carriage controls are different, it ignores the value of the xcc conversion parameter and uses the carriage control type that it found. xpcctest=yes is the default.

The xpcctest parameter is useful for installations that have Xerox jobs that contain both ANSI and machine carriage controls. For example, a multi-step job on z/OS might have an initial step that consists of banner pages with ANSI carriage controls. The subsequent steps that contain the actual data for the job have machine code carriage controls. When Infoprint XT reads the first records of the job as directed by xpcctest=yes, it finds the ANSI carriage controls in the banner pages. It then ignores the value of the xcc parameter and uses a value of ANSI. The AFP output that Infoprint XT generates is not correct. In this case, you can use xpcctest=no. This prevents Infoprint XT from verifying the carriage controls in the first few records of the job, and causes it to use the value of the xcc parameter.

In some cases, specifying xpcctest=no might not produce correct output because of the particular combination of ANSI and machine code carriage controls in the job data. In these cases, you must correct your application so that it specifies either ANSI or machine code carriage controls throughout the job data that it generates.

xptxmaxareas = areas

Specifies the total number of primary and secondary internal data areas that Infoprint XT uses during data stream conversion.

If you omit the parameter, Infoprint XT calculates the maximum number of primary and secondary internal data areas that can be allocated by using the available virtual storage.

Notes:

The intent of xptxsize and xptxmaxareas, combined with the Language Environment® HEAP parameter, is to let you allocate an area of virtual storage above the 16 MB line that is large enough to hold all the internal data that Infoprint XT needs to convert the data stream. Since it is difficult to know in advance exactly how much virtual storage is needed, you can use the secondary xptxsize parameter value to decrease the chances of using I/O to SYSUT1 and yet avoid requesting more storage than your job actually needs.
To make effective use of the xptxsize parameter with the AIOZ2AFP program, you must include the HEAP Language Environment parameter in your JCL EXEC statement. If you are using Infoprint XT with Infoprint Server, add the HEAP parameter to _CEE_RUNOPTS in the environment section of the x2afp transform definition in the aopxfd.conf file.
The effect of HEAP is to provide sufficient virtual storage to allocate the Infoprint XT internal data areas above the 16 MB line. The initial HEAP value should be at least as large as the xptxsize primary value. The secondary HEAP value should be at least as large as the secondary xptxsize value.

You should use the default HEAP ANYWHERE subparameter. Do not specify BELOW with the HEAP parameter. Even though Infoprint XT is able to determine storage limits below the 16 MB line, the use of BELOW does not improve Infoprint XT performance and might even degrade it.
If a large amount of data is being processed and too much virtual storage is being used, xptxmaxareas lets you limit the number of secondary data areas that are allocated.
If you request a primary xptxsize greater than the maximum amount of available virtual storage, Infoprint XT issues a message to indicate that your request exceeded the upper limit and that it has adjusted the requested primary xptxsize to conform to the maximum allowed. If you also requested a secondary xptxsize value, Infoprint XT issues a message indicating that it does not allocate secondary data areas since the primary area uses all of the available space. Infoprint XT also issues this message if the space remaining after the allocation of the primary data area is less than 12 KB.
If the internal data storage requirements exceed the size of the primary data area, Infoprint XT allocates and uses secondary areas as long as space is available and the number of areas does not exceed the maximum. This limit is the smaller of the maximum calculated by Infoprint XT or the value you specify for the xptxmaxareas parameter.
When more than one area is used, Infoprint XT issues a message to indicate how many areas were allocated and the primary xptxsize value that Infoprint XT would require to use only one area. This information can be helpful in improving performance of other jobs, since allocating multiple internal data areas can increase execution time because of the additional requests to get system storage.
If the amount of data processed exceeds the size of the available primary and secondary internal areas, Infoprint XT writes the remaining internal data to temporary dataset SYSUT1. This additional I/O might increase execution time.
When Infoprint XT writes data to SYSUT1, it issues a message to indicate how much data is involved and to recommend xptxsize and HEAP values that could avoid I/O to SYSUT1.

xptxsize = primary_sizeU:secondary_sizeU

Specifies the sizes of the primary and secondary internal data areas that Infoprint XT uses during data stream conversion. The minimum size for the primary and secondary data areas is 12 KB. The maximum size depends on the amount of virtual storage available to the job.

U specifies the data size units as K (kilobytes) or M (megabytes).

For example, if you specify xptxsize=32M:4M, Infoprint XT allocates one primary internal data area of 32 MB and as many secondary areas of 4 MB as are required to convert the data stream, up to the maximum amount of virtual storage available to the job.

If you omit the parameter, Infoprint XT uses the default value of xptxsize=832K:832K.

xrecfm = fixed | variable

Specifies the record format of the records in the job. For fixed length records, as specified by the default xrecfm=fixed, the xlrecl parameter specifies the length of the record. xrecfm=variable specifies that the records are variable length, with a 2-byte length field at the beginning of each record. The record length does not include the 2-byte length field itself.

xrptfile = . | fullpath

Specifies the path and file in which Infoprint XT writes a report of all DJDEs found in the job. Specifying xrptfile=. causes Infoprint XT to write the report to the x2afp.djde file in the working directory for the job. The default working directory for the job is /var/pdxt/jobs/jobname-jobID-n. If you do not specify this parameter, Infoprint XT does not generate a DJDE report.

Note: If you specify a path, make sure that it is the full path. You cannot use a relative path with the xrptfile parameter.

xshading = xerox | grayscale | [ lp ]:[ mp ]:[ hp ]

Controls how Infoprint XT interprets Xerox shading when it converts the Xerox data stream and any inline FRMs that FILE DJDEs specify. Valid values are:

xerox

Infoprint XT emulates Xerox shading and produces raster dot patterns in the AFP that it generates. This is the default.

grayscale

Infoprint XT uses Logical Page and Object Area Coloring to substitute grayscale for the standard shading characters in FRMs. It uses default percentages of grayscale coverage for the levels of Xerox shading:

LIGHT: Five percent (5%) coverage.
MEDIUM: Ten percent (10%) coverage.
HEAVY: Fifteen percent (15%) coverage.

[ lp ]:[ mp ]:[ hp ]

Infoprint XT substitutes grayscale for the Xerox shading and uses the coverage percentages you specify. For each position in the value, you can specify an integer from 0 through 100:

lp: The coverage percentage that Infoprint XT uses for LIGHT shading.
mp: The coverage percentage that Infoprint XT uses for MEDIUM shading.
hp: The coverage percentage that Infoprint XT uses for HEAVY shading.

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.
xshading = 3: Infoprint XT uses 3% coverage for LIGHT shading, 10% for MEDIUM, and 15% for HEAVY.
xshading = :11: Infoprint XT uses 5% coverage for LIGHT shading, 11% for MEDIUM, and 15% for HEAVY.
xshading = ::14: Infoprint XT uses 5% coverage for LIGHT shading, 10% for MEDIUM, and 14% for HEAVY.
xshading = 4:9:12: Infoprint XT uses 4% coverage for LIGHT shading, 9% for MEDIUM, and 12% for HEAVY.

Restrictions apply when you use the xshading conversion parameter. See Grayscale substitution for Xerox shading.

xspacing = none | word | trnw | char

Specifies adjustments that Infoprint XT makes to the spacing to match the original Xerox output as closely as possible. This conversion parameter also affects spacing fidelity for inline FRMs in FILE DJDE jobs. Valid values are:

none: Specifies no spacing adjustment. This is the default.
word: Specifies spacing adjustments between words only.
trnw: Specifies spacing adjustments between words only and reduces or eliminates embedded blanks in Presentation Text Object Content Architecture text characters.
char: Specifies spacing adjustments between words and characters.

Notes:

Use of word adjustments or character adjustments affects Infoprint XT performance and results in larger AFP files.
The value of this attribute affects how Infoprint XT processes jobs that contain FILE DJDE commands.

xspcrmi = yes | no

Controls how Infoprint XT interprets spacing characters in Xerox fonts during job processing for fonts that FILE DJDEs specify:

no: Infoprint XT interprets spacing characters in the font as Presentation Text Object Content Architecture text-string characters. This is the default.
yes: Infoprint XT interprets spacing characters in the font as Relative Move Inline structured fields.

Restrictions apply when you use the xspcrmi conversion parameter. See Spacing characters in Xerox fonts.

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.

xstaplemax = n

Specifies the maximum number of sheets that accumulate before a staple action occurs. You can specify a value from 1 through 32767. This matches the values that Xerox printers support. However, Xerox printers do not staple more than 102 sheets at a time. Infoprint XT issues a warning message for each sheet, over 102 sheets, that accumulates for a single stapling action.

Notes:

The printer model that you are using determines the number of sheets that you can staple at one time. For detailed information, see the documentation for the printer.
If you do not specify the xstaplemax conversion parameter, Infoprint XT accepts the NTO1 limits that the JDEs for the job specify.

xstapleorient = yes | no

Specifies whether Infoprint XT accepts the orientation of the first page of a report when it determines the corner in which to staple. The default is that Infoprint XT always staples in the upper left corner of the pages, as you look at them in the portrait orientation. If you specify xstapleorient=yes, Infoprint XT detects reports whose first pages are in the landscape orientation. It staples these in the lower-left portrait corner. This corresponds to the upper-left landscape corner.

xstaplesysgen = nto1 | 1ton

Specifies whether the default printing order that was specified to the Xerox printer at SYSGEN time was 1TON or NTO1. This determines whether the Xerox printer delivers the printed output starting with the first page of the job or with the last. If you use the default xstaplesysgen=1ton, the starting JDL and JDE pair for the job must include:

STAPLE=YES
NTO1=YES or NTO1=n
FACEUP=YES

If these values are present in the starting JDL and JDE pair, Infoprint XT includes stapling commands in the AFP output that it generates. If the values are not present, no stapling occurs. This is true even if subsequent JDL and JDE pairs in the job specify stapling.

If you specify xstaplesysgen=ntol and subsequent JDL and JDE pairs in the job specify stapling, Infoprint XT includes stapling commands in the AFP regardless of whether the starting JDL and JDE pair specifies stapling.

xtblkln = n

For offline jobs, this conversion parameter specifies the block length. If you do not specify this parameter, Infoprint XT uses the value that the starting JDE specifies. For Infoprint XT to accept the xtblkn conversion parameter, you must specify xdeblock=yes.

xtoffset = n

For offline jobs, this conversion parameter specifies the buffer offset. If you so not specify this parameter, Infoprint XT uses the value that the starting JDE specifies. For Infoprint XT to accept the xtoffset conversion parameter, you must specify xdeblock=yes.

xtrblanks = no | yes

Specifies whether Infoprint XT removes the trailing blanks on each line of the input data stream. If you do not specify this parameter, Infoprint XT does not remove the trailing blanks.

xwarnrc = none | all | msg1:msg2:msg3

Controls the return code that Infoprint XT generates when it issues warning messages.

none: Warning messages result in a return code of at least 4. This is the default.
all: Infoprint XT changes the return code associated with all warning messages from 4 to 0.
msg1:msg2:msg3: Infoprint XT changes the return code associated with the message numbers that you specify from 4 to 0. You can specify up to three warning message numbers. Separate the message numbers with colons.

These are examples of values you can specify:

xwarnrc=all: If Infoprint XT issues any warning messages while converting a job, and does not issue any messages with a severity higher than W, it changes the resulting return code for the job from 4 to 0.
xwarnrc=5019-181:5019-192: While converting a job, if Infoprint XT issues message 5019-181 for an ignored DJDE record or message 5019-192 for an incorrect COLLATE DJDE, and does not issue any other warning messages or messages with a severity higher than W, it changes the resulting return code for the job from 4 to 0.

Notes:

This parameter can be useful when the job should end with return code 0 for Infoprint XT to interact properly with other software, such as Infoprint Server, and the warnings that Infoprint XT issues do not affect the AFP output for the job. For example, if an input file contains multiple consecutive DJDE packets, you can specify the default xconsecutivedjde=ignore parameter to cause Infoprint XT to process the first DJDE packet and ignore the second DJDE packet. Infoprint XT issues a warning message when it ignores the second DJDE packet. If the AFP output for the job is correct, you can use the xwarnrc parameter to change the ending return code from 4 to 0.
If Infoprint XT issues one or more data stream converter messages with severities of E, S or U, the job ends with the highest corresponding return code, regardless of whether you specified the xwarnrc parameter.
The xwarnrc parameter only applies to data stream converter warning messages (5019-nnn W).

xzctrace = yes | no

Captures trace information that an IBM service 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 an IBM service representative.

xztrace = all1:all2

Captures trace information in the resource utility and data stream converter components that an IBM service 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 an IBM service representative.