Transform error handling

You can control how the AFP to PCL, AFP to PDF, and AFP to PostScript transforms handle errors that occur during the transform. You can control whether the transform:

• Stops transforming a document when a data stream error or warning occur. The transform does not create any output. By default, the transforms stop processing when a data stream error occurs but not when a warning occurs.
• Adds a page at the end of the output document with informational, warning, and error messages (called the trailer page). By default, the transforms add a trailer page when a data stream warning or error occurs.

You can control transform error handling in these ways:

• Job submitters can specify the fail-on-transform-error and trailer-transform-error-page job attributes. For information, see Job attributes for error handling.

  These are some of the ways you can specify job attributes, depending on how you submit the transform or print request:

  • In the -j option of the afpxpcl, afpxpdf, and afpxps commands
  • In the PRTATTRS parameter of the OUTPUT JCL statement
  For information, see Using transforms.
• Administrators can specify the Fail on error and Trailer error page fields in Infoprint Server printer definitions. For information, see Administering transforms.
• Administrators can specify the AOP_FAIL_ON_ERROR and AOP_TRAILER_ERROR_PAGE environment variables in the Infoprint Server transform configuration file. For information, see Customizing transforms.

Table 1 shows the job attributes, printer definition fields, and environment variables that you can specify.

The transforms use the values in this order:

1. Job attribute
2. Field in printer definition (print request only)
3. Transform environment variable