The afp2pdf transform configuration file

Parameters to control settings for the afp2pdf transform are specified in a configuration file. By default, the name of this file is afp2pdf.cfg. For AIX or Linux, the file is located in /usr/lpp/psf/afp2pdf. For Windows, the file is located in install_path\afp2pdf.

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. The information after a pound sign (#) is considered a comment and 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.
    Note:
  • Options specified on the command line override options in the configuration file.

The parameters for the afp2pdf transform options are:

AFM_PATH=<path>
This parameter specifies the path location of the Adobe Font Metrics (AFM) files that the transform uses. An AFM stores font metric data for a Type 1 PostScript font. It contains the master design of a specific font, which defines the way each character of the font looks. If a path is not specified, the default path is:
For AIX or Linux
/usr/lpp/psf/afp2pdf/font/AFM
For Windows
install_path\afp2pdf\font\AFM

There is no command line flag associated with the AFM_PATH parameter.

CNV_PATH=<path>
This parameter specifies the path location of the CNV files that the ICU library uses to convert text from one code page to Unicode and vice versa. If a path is not specified, the default path is:
For AIX or Linux
/usr/lpp/psf/afp2pdf/cnv
For Windows
install_path\afp2pdf\cnv

There is no command line flag associated with the CNV_PATH parameter.

DEFAULT_CPID=<intValue>
This parameter specifies a default Code Page Identifier (CPID) to be used when transforming AFP or SCS files.
If a DEFAULT_CPID is not specified when transforming AFP files, a default value based on the cpdef file will be used.
If a DEFAULT_CPID is not specified when transforming SCS files, CPID 500 will be used as the default.
There is no command line flag associated with the DEFAULT_CPID parameter.
DEFAULT_FGID=<intValue>
This parameter specifies a default Font Global Identifier (FGID) to be used when transforming AFP or SCS files.
If a DEFAULT_FGID is not specified when transforming AFP files, a default value based on the csdef file will be used.
If a DEFAULT_FGID is not specified when transforming SCS files, FGID 11 (Courier) will be used as the default.
There is no command line flag associated with the DEFAULT_FGID parameter.
DISABLE_MEMSREAM=(TRUE|FALSE)
When this parameter is set to TRUE, it specifies that during the transformation, the content of the PDF document will be written in temporary files created on disk, no matter the size of the AFP document. This parameter is useful if the output PDF document is too large to be kept in memory until the transformation is completed. By default, the PDF document content is kept in memory for an AFP document smaller than 10 MB; otherwise, temporary files are used.

There is no command line flag associated with the DISABLE_MEMSTREAM parameter.

ENABLE_AUTO_FONT_IMAGE=(TRUE|FALSE)
When this parameter is set to TRUE, it specifies that the output PDF document will contain an image for each character that was written with a raster font in the AFP document. By default, the raster fonts will be replaced with another font, and all characters will be written as text in the PDF document. However, some of the characters might look different from their raster form.

There is no command line flag associated with the ENABLE_AUTO_FONT_IMAGE parameter.

FOCA_FONT_PATH=<path>
This parameter specifies the path where the AFP FOCA fonts are installed. The default path is:
For AIX
/usr/lpp/psf/fontlib
For Linux
install_path/afp2pdf/reslib
For Windows
install_path\afp2pdf\reslib
There is no command line flag associated with the FOCA_FONT_PATH parameter.
FONT_PATH=<path>
This parameter specifies the path location of the font files that the transform uses when writing the PDF document. If a path is not specified, the default path is:
For AIX or Linux
/usr/lpp/psf/afp2pdf/font
For Windows
install_path\afp2pdf\font

There is no command line flag associated with the FONT_PATH parameter.

MAX_OBJECTS=<number>
This parameter specifies the maximum objects that can be listed in the PDF cross-reference table (XREF). If the AFP file contains more objects than this, the additional ones are ignored. This setting is provided for use with the MAX_PAGES setting. For example, if MAX_PAGES is set to a number greater than 1000, the value assigned to MAX_OBJECTS might need to be set to a number greater than 50000.

By default, MAX_OBJECTS and MAX_PAGES are commented out, which does not limit the number of objects or pages.

There is no command line flag associated with the MAX_OBJECTS parameter.

MAX_PAGES=<number>
This parameter specifies the maximum pages to be converted. You can use this parameter to limit the number of pages generated by the transform. For example, if the number of pages in an AFP document is not known and you want to limit disk space usage, you might want to set a limit on the number of pages generated by the transform. Limiting the number of pages can also improve transform performance.

By default, MAX_PAGES and MAX_OBJECTS are commented out, which does not limit the number of pages or objects.

There is no command line flag associated with the MAX_PAGES parameter.

OVERLAYEXT=<ListOfExtenstions>
PAGESEGEXT=<ListOfExtenstions>
FORMDEFEXT=<ListOfExtenstions>
JFIFext=<ListOfExtenstions>
GIFEXT=<ListOfExtenstions>
TIFFEXT=<ListOfExtenstions>
These parameters specify the accepted extension for a resource type. The possible extension are separated by a comma (,). For each extension, a * (asterisk) will be replaced with the name of the searched resource. Therefore, specifying an * (asterisk) means no e