apped utility: starts the apped daemon

Syntax

apped [-C ConfigurationFile]

Description

Use the apped utility to start the apped daemon. The apped daemon manages the APPE processor portion of the InfoPrint PDF transform programs. You must start the apped daemon somewhere on the network before you can use the ps2afp or pdf2afp transform command to transform PDF data streams for printing with InfoPrint on IPDS and InfoPrint 4100 printers.

The startsrv or start_server utility automatically starts the apped daemon if it is installed and not running.

If the apped daemon stops running, you can restart it by issuing the following command:

apped -C /usr/lpp/psf/ps2afp/apped.cfg

InfoPrint Manager uses the apped daemon configuration file to determine the default parameters of the apped daemon. The /usr/lpp/psf/ps2afp/apped.cfg file is installed with InfoPrint Manager, and InfoPrint Manager uses it as the default configuration file. You can, however, copy the configuration file, use an editor to edit the copy of the file, and rename it so that you can customize the apped daemon for your applications. After you make the modifications, you specify the new configuration file with the -C flag of the ps2afp transform command when you transform PDF files.

APPE supports only job level changes to the configuration files. Other changes must be accompanied by a daemon restart to come into effect.

Flag

The apped daemon utility uses the following flag:

-C ConfigurationFile
Specifies the configuration file InfoPrint uses with the transform. The value is:
ConfigurationFile
A valid configuration file name. If you do not specify a file, InfoPrint uses the file /usr/lpp/psf/ps2afp/apped.cfg.

Configuration file keywords and values

The apped.cfg file contains the same keywords as the ps2afp.cfg file except that the transform daemon configuration file does not have the server keyword. The apped.cfg contains several additional keywords.

For the keywords common to both configuration files, see The agspdld, apped, ps2afp, and ps2afpd configuration files.

The apped transform daemon configuration file can also contain the following keywords:

appe_work_directory={/var/psf/appe | PathName}
Specifies the path to the directory where the transform daemon puts its work files. The transform daemon must have read, write, and execute permissions to this directory. The transform daemon is owned by the root user, but runs as daemon, and is in the printq group.
Note: Only one apped can use the appe_work_directory at a time. It cannot be shared.

Values:

/var/psf/appe
The default work directory
PathName
A directory path

log_file={/var/psf/appe/apped.log | PathName}
Specifies the file in which the transform daemon logs errors and messages when it converts a data stream from PDF to an AFP data stream.

Valid keyword values are:

/var/psf/appe/apped.log
This is the default log file.
PathName
This is the full path name of a log file.

log_size={100 | Size}DEFAULT=100
Specifies in kilobytes how large the log file can get before it is renamed <log_file>.bak and a new empty log file is used.

Default value
100

transform_trace_file={/var/psf/appe/appeTraceFile.log| PathName} DEFAULT=/var/psf/appe/appeTraceFile.log
Specifies the file where to write APPE transform trace information.

Valid keyword values are:

/var/psf/appe/appeTraceFile.log
This is the default trace file.
PathName
This is the full path name of a trace file.

transform_trace_size={200 | Size} DEFAULT=200
Specifies in kilobytes how large the trace file can get before it is renamed <transform_trace_file>.bak and a new empty tracefile is used.

Default value
200

transform_trace_level={MDFL@-1 | TraceLevel} DEFAULT=MDFL@-1
Specifies the active trace group for the APPE transform.

Valid keyword values are:

MMST@-1
Outputs most trace statements.
MINT@-1
Outputs intermediate trace statements.
MDFL@-1
Outputs default trace statements.

appe_fonts_path=[PathName]
Specifies the paths for the directories where the extra fonts for Adobe PDF Print Engine transforms are located.
Note: To make sure that the application reads separate paths correctly, enter the ";\" separator and new line between two entries. It is not necessary to enter the ";\" separator after the last line.

Default Value
None

appe_font_map_files={/usr/lpp/psf/appe/fontmaps/FontMapSample.cfg | PathName} DEFAULT=/usr/lpp/psf/appe/fontmaps/FontMapSample.cfg
Specifies the path and file name Adobe PDF Print Engine uses for the font mapping file. This file correlates font names with their file locations.

Valid keyword values are:

usr/lpp/psf/appe/fontmaps/FontMapSample.cfg
This is the default font mapping file.
PathName
This is the full path name to the font mapping file.

Examples

  • To restart the apped daemon with the default configuration file, enter:
    apped -C /usr/lpp/psf/ps2afp/apped.cfg
      Note:
    1. If you have not set the PATH environment variable to include /usr/lpp/psf/bin, you must enter the path name with the apped daemon.
    2. Anyone can start the apped daemon, but only a person with root user authority can stop it.
  • To restart the apped daemon with the configuration file myfile.cfg, which resides in the directory /usr/lpp/psf/ps2afp, enter:
    apped -C /usr/lpp/psf/ps2afp/myfile.cfg
  • You can only run one instance of apped daemon at a time.

Files

/usr/lpp/psf/bin/apped
Adobe PDF Print Engine transforms daemon
/usr/lpp/psf/bin/ps2afp
PostScript transform executable
/usr/lpp/psf/bin/pdf2afp
PDF transform executable (linked to /usr/lpp/psf/bin/ps2afp)
/usr/lpp/psf/ps2afp/apped.cfg
apped daemon configuration file
/usr/lpp/psf/ps2afp/ps2afp.cfg
ps2afp command configuration file