Flags and values

-C ConfigurationFile
Specifies the path and file name of the customized configuration file InfoPrint uses with the transform. The configuration file contains option-value pairs. If you specify multiple -C options on the command line, the configuration files are processed in the order that you specify them.

If you specify the -C flag with an AIX print command (enq, lp, or qprt), or with the lprafp command, specify the fully qualified name of the file, including its path; for example:

With AIX or Linux
/usr/lpp/psf/xmltransform/myfile.cfg

-F outline_font_index | raster_font_index | fontindexname | none
DEFAULT=outline_font_index
Specifies the path and file name of the customized font index file InfoPrint uses with the transform. The font index files specify mappings between fonts (such as, sizes and weights) and character sets and code pages. If you specify the -F flag with an AIX print command (enq, lp, or qprt), or with the lprafp command, specify the fully qualified name of the file, including its path; for example:
For AIX or Linux
/usr/lpp/psf/xmltransform/myfontfile
For Windows
install_path\xmltransform\myfontfile
The font index files built into xml2afp include one that specifies outline fonts (outline_font_index) and one that specifies raster fonts (raster_font_index). You can define your own font index file or use the ones supplied with xml2afp.
The default font index file is outline_font_index.
-t tracefilename
Requests a trace for diagnostic purposes. Trace output is written to the specified file. A fully qualified path should be specified. If a relative path is provided, the path is relative from the directory where the xml2afp transform is invoked.
A dash can be specified for tracefilename. When a dash is specified, the trace is written to standard error.
-a { PT1_NO_COLOR | PT1 | PT2 | PT3 }
  • Indicates the level of PTOCA supported by the target printer. This is used to generate proper color commands.
  • Values are:
    PT1_NO_COLOR
    Converts all color commands to black. Use this option when a black and white printer is used that does not provide grey scaling simulation of colors. Typically, older printers do not provide this function, but newer printers do provide this function.

    The default is PT1_NO_COLOR.

    PT1
    Uses the basic PTOCA set color commands. Use this option on newer black and white printers that provide grey scale simulation of colors and printers that support highlight color.
    PT2
    This option is functionally equivalent to PT1, and it is provided for completeness with the PTOCA Architecture.
    PT3
    Uses the extended PTOCA set color commands. Use this option on printers that provide full process color support.
-f fontpathlist
Indicates the path or paths to the AFP font resources to use to print the output file. Information from the AFP font resources is used to format the output file.
If multiple paths are specified, they must be delineated by colons on AIX or Linux .
There is no program default, although a configuration default is provided in the configuration file.
-l 11i |nnn.nnn
Indicates the length of the page on which the output is printed. Specify a number followed directly by one of these units:
i
inches, the default
m
millimeters
For example: 
-l 17i
  • The default is 11 inches.
  • The maximum value is 22.75i or 577.97m.
-o OutputFile
Specifies the output path and file into which the transformed files are to be written. If you do not specify the -o flag or if you specify a dash (-), InfoPrint writes the results to standard output.
-s { stylesheet | none }
DEFAULT=none
Specifies the name of the stylesheet used to transform XML data to XSL-FO data or whether no style sheet should be used.

Values are:

none
Specifies that no style sheet is to be used.

The default is none.

stylesheet
Specifies the file or URL for an XSL style sheet that is used to transform XML data to XSL-FO data. For example:
  • http://rpp.ricoh-usa.com/report.xsl
  • ftp://ftp.rpp.ricoh-usa.com/report.xsl

This option should only be specified when the input file contains XML data that must be transformed according to a specified style sheet; not when the input file contains XSL-FO data.

When you use the xml2afp as a standalone transform, it runs with the user’s authority. When the xml2afp runs as an InfoPrint Manager server transform, it runs with InfoPrint Manager's authority. Therefore, if the transform is running under InfoPrint Manager, xml2afp must be able to access the file or resource named by the style sheet URL. For example, if report.xsl is the style sheet file a URL refers to, its file permissions must allow others to read it.
-T
Specifies that the transform should use OpenType fonts found in the resource path. This generates MOD:CA that uses the OpenType AFP structured fields. The output only prints on IPDS printers that support OpenType fonts.
If the font specified in the XML input file is not an OpenType font, the font index file, if specified, is used to map the font to a FOCA font.
-w 8.5i |nnn.nnn
Indicates the width of the page on which the output is printed. Specify a number followed directly by one of these units:
i
inches, the default
m
millimeters
For example: 
-w 11i
  • The default is 8.5 inches.
  • The maximum value is 22.75i or 577.97m.
Inputfile
Specifies one or more input files to be transformed to AFP. An input file contains either XML data with no presentation information or XML data with XSL formatting objects (XSL-FO). If you specify multiple input files with a style sheet, each file is transformed according to the style sheet. Therefore, it is recommended that when you specify a style sheet, all input files contain XML data only.
If you do not specify an input file name, or if you specify a dash (-), the xml2afp transform uses standard input for the input file. If you specify more than one input file name, the xml2afp transform writes the output to a single AFP data stream that consists of multiple documents.
Note: The Inputfile must be the last entry on the command line.
Parent topic: xml2afp transform: transforms XML data to AFP