Parameters

tiff2afp behavior is governed by many parameters. The parameters are set by this hierarchy (least significant first):

  • Internal defaults
  • Environment variables
  • Configuration file
  • Command-line arguments

Command line arguments

  • Options and input file names can appear on the command line in any order.
  • When you run tiff2afp as a standalone transform, the blank between option and value is optional (for example, both -inkblack and -ink black are valid).
  • When you use the -o flag of the enq, lp, qprt, or lprafp commands to pass options to tiff2afp, no blank is permitted between option and value (for example, -o-inkblack is valid, but -o -ink black is not).
  • When you use the other-transform-options attribute on the pdpr command to pass options to tiff2afp, any string containing a blank must be surrounded by single quotes (for example, both other-transform-options=-inkblack and other-transform-options='-ink black' are valid).
  • All values except file names are case-insensitive.
  • If an option is specified multiple times, the last specification remains in force.
  • If multiple configuration file names are given, they are processed in order.

Configuration file

The configuration file has entries of the form option=value, where each pair must be on a separate line. Options and other syntax are the same as for the command line arguments and the option names are the same. Input files and configuration files cannot be specified in the configuration file (that is, nested configuration files are not supported). In the case of options without values (for example, -inv), the equals sign must be present.

Some command line options, for example, -calib, cannot be used in the configuration file or as environment variables. Options available only on the command line are noted as such in their descriptions.

If you do not specify a configuration file on the command line with the -C option, the transform checks for the existence of the default configuration file, /usr/lpp/psf/tiff2afp/tiff2afp.cfg. If this file exists, the transform uses it as the configuration file.

Here is an example of a valid configuration file:

scale = letter
r= 300
o = -
inv=
alg=afp
Note: The spaces around the equals sign (=) are optional. In this example, the option-value pair o = - means that the default output file is the standard output. Output file name computation has been disabled.

Environment variables

Environment variables have the form TIFF2AFP_option, where option is the same as on the command line and the configuration file.

Some command line options, for example, -calib, cannot be used in the configuration file or as environment variables. Options available only on the command line are noted as such in their descriptions.

For example, to achieve the same effect as the configuration file in the last example, these statements have to be executed in the calling shell:

export TIFF2AFP_scale=letter
export TIFF2AFP_r=300
export TIFF2AFP_o=-
export TIFF2AFP_inv=" "
export TIFF2AFP_alg=afp
There must be some value set for each desired option. For options that do not take a value, specify a blank surrounded by double quotes, for example:
export TIFF2AFP_inv=" "    correct
export TIFF2AFP_inv=       has no effect