Flags and values

This section describes the flags and values for the xml2pdf transform:
-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

-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 xml2pdf transform is invoked.
A dash can be specified for tracefilename. When a dash is specified, the trace is written to standard error.
-l 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://www.yourdomain.com/report.xsl
    • ftp://ftp.yourdomain.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 xml2pdf as a standalone transform, it runs with the user’s authority.
-w 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, IBM recommends that when specifying 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 xml2pdf transform uses standard input for the input file. If you specify more than one input file name, the xml2pdf 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.