Tasks for using the XML to PDF transform

The sample xml2pdf configuration file is provided in /usr/lpp/psf/xml2pdf/xml2pdf.cfg. The default paper size can be modified. Additionally, defaults for all the xml2pdf options can be set in the configuration file.

The syntax of the configuration file is exactly the same as the command line syntax with these additional rules:

  1. Blank lines are ignored.
  2. All data on a line after a pound sign is ignored. The pound sign can occur anywhere on a line.
  3. To include a pound sign in parameter data, it must be escaped; that is, it must be preceded by a backwards slash.
  4. White space before and after parameter data is removed.
  5. Parameter data on successive lines is concatenated with a single space between them.
  6. Parameters can span lines as long as they follow rules 1 through 5.

These are the common tasks you must do when using the XML to PDF transform:

  1. Create the XML Extender configuration file, xml2pdf.cfg, which lets you configure XML Extender. To create the file:
    • Copy the sample configuration file, /usr/lpp/xml2afp/samples/xml2pdf.cfg, to /etc/xml2pdf.cfg:
      cp /usr/lpp/xml2afp/samples/xml2pdf.cfg /etc/xml2pdf.cfg
      Note: If you want to modify the sample configuration file, you still need to copy it.
  2. Edit the file using your preferred editor.

    If necessary, customize these items:

    • Java executable location with the JAVA keyword
    • The xml2pdf transform location with the XML2PDF_BASE keyword, if it is installed in a location other than install_path\xml2pdf
    • Memory the Java virtual machine uses to run the transform with the HEAP_SIZE keyword

    Important: The configuration file is a shell script. You can use any commands that are valid according to /bin/sh. However, because the script runs for each invocation of the xml2pdf transform when it is not managed by InfoPrint Manager, avoid using any commands that take a long time to complete.

See "xml2pdf Command: transforms XML data to PDF" in the "InfoPrint Manager Tools" chapter in InfoPrint Manager: Reference for the sample XML transforms configuration file that is shipped with the xml2pdf transform.