Configuring PDF settings for email jobs

The PDF settings parameters for email jobs 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

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

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 or Linux

/usr/lpp/psf/fontlib

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

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

GOCA_PASS1=<number>

The <number> for this parameter can be 0,1, or 2.

When processing an afp file, there are 2 passes, an image pass and a text pass.

Setting this attribute will tell when to process the GOCA objects.

• GOCA_PASS1=0, goca objects processing are disabled.

• GOCA_PASS1=1, goca objects are processed in the image pass.

• GOCA_PASS1=2, goca objects are processed in the text pass.

The default value is 2.

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>

CHARSETEXT=<ListOfExtensions>

CODEPAGEEXT=<ListOfExtensions>

CODEDFONTEXT=<ListOfExtensions>

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 extension.

When searching by name in the RESOURCE_DATA_PATH, the transform first tries the name with no extension. If it does not succeed, it tries with every extension from the list until the resource is found.

By default, the extension list is an * (asterisk).

There is no command line flag associated with these parameters.

PDF_FONT_MAP_FILE = <path>

This parameter specifies the path location of the fontmap.lst file that maps the Type 1 Fonts. When specified, it means that the user wants to embed Type 1 Fonts into the PDF document. If a path is not specified, the default path is:

For AIX or Linux

/usr/lpp/psf/afp2pdf/font/fontmap.lst

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

PFMPFB_DIRECTORY=<path>

This parameter specifies the path location of the Adobe Type 1 outline font files that the transform uses when embedding fonts inside of the PDF document. When simple font substitution is not acceptable in the PDF output, it is possible to embed a custom Type 1 font inside the PDF for better results. If a path is not specified, the default path is

For AIX or Linux

/usr/lpp/psf/afp2pdf/font/type1

Note: Placing Type 1 font files in this directory does not mean that they are automatically placed inside of the PDF file. For a font to be embedded, it must be mapped using the transform font definition files.

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

PRAGMA_FDEF= <filename>

This parameter specifies the file name of the form definition (FORMDEF) resource to be used when transforming the AFP file. If an inline form definition is associated with the AFP document, then both the FDEF from the configuration file and the command line are ignored. If FDEF is not included in the configuration file or specified on the command line, the F1A10110 default form definition is used.

Command line flag:

 -pragma fdef <filename>

Command line example:

-pragma fdef=myformdef.fde

PRAGMA_ALIGNTEXT=<angle>

This parameter specifies the rotation value to use when transforming the file. Valid values are 0, 90, 180, or 270 (clockwise). Some AFP files might have already been formatted with a rotated orientation. If this occurs, text is aligned with the vertical axis of the paper rather than the horizontal axis. To correct this, you must use this parameter to align the text as desired.

Command line flag:

-pragma aligntext <angle>

Command line example:

 -pragma aligntext=90

VERBOSE

This parameter specifies verbose information will be generated to stderr.

Command line flag:

-v

OUTPUTFILE=<path+filename>

This parameter specifies the path and filename of the output PDF file. By default, the output PDF file is placed in the same directory as the input file, and it has the same file name as the input file with the extension changed from afp to pdf. For example, when the PDF is generated from an AFP file named afpdoc.afp, an output file named afpdoc.pdf is created.

Note: If AFP is not used as the extension, a pdf extension is still added to the output PDF file.

Command line flag:

 -o <path+filename>

Command line example:

-o c:\mydirectory\mystream.pdf

RESOURCE_DATA_PATH =<path>

This parameter specifies the path location of the resource library. For all the external resources used by the AFP document (formdef, overlay, page segment, jfif, gif, IOCA image), the transform looks for them in this specified path. If a path is not specified, the default path is:

For AIX or Linux

/usr/lpp/psf/afp2pdf/reslib;/usr/lpp/psf/reslib

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

TT_FONT_PATH=<path>

This parameter specifies the location of the TrueType font or the TrueType Collection used. If a path is not specified, the default path is:

For AIX or Linux

/usr/lpp/psf/afp2pdf/font/truetype