Parameters

jpeg2afp 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 jpeg2afp as a standalone transform, the blank between option and value is optional (for example, both -fittrim and -fit trim are valid).
  • When you use the -o flag of the enq, lp, qprt, or lprafp commands to pass options to jpeg2afp, no blank is permitted between option and value (for example, -o-fittrim is valid, but -o -fit trim is not).
  • When you use the other-transform-options attribute on the pdpr command to pass options to jpeg2afp, any string containing a blank must be surrounded by single quotes (for example, both other-transform-options=-fittrim and other-transform-options='-fit trim' 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, -v), the equals sign must be present.

Some command line options 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/jpeg2afp/jpeg2afp.cfg with InfoPrint Manager for AIX or InfoPrint Manager for Linux and install_path\jpeg2afp\jpeg2afp.cfg with InfoPrint Manager for Windows. 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 = -
v=
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 JPEG2AFP_option, where option is the same as on the command line and the configuration file.

Some command line options 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 JPEG2AFP_scale=letter
export JPEG2AFP_r=300
export JPEG2AFP_o=-
export JPEG2AFP_v=" "
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 JPEG2AFP_v=" "    correct
export JPEG2AFP_v=       has no effect