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