ps2afpd utility: starts the ps2afpd daemon


ps2afpd [-C ConfigurationFile]


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

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

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

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

InfoPrint Manager uses the ps2afpd daemon configuration file to determine the default parameters of the ps2afpd daemon. The /usr/lpp/psf/ps2afp/ps2afpd.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 ps2afpd daemon for your applications. After you make the modifications, you specify the new configuration file with the -C flag of the ps2afpd daemon utility.

Note: If you create your own configuration file, you must specify it with the -C flag of the ps2afp transform command when you transform PostScript or PDF files.


The ps2afpd daemon utility uses the following flag:

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

Configuration file keywords and values

The ps2afpd.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 ps2afpd.cfg contains several additional keywords.

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

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

device_controls=[plex,][ inputw=(size[,type=x,color=y,weight=z)][ inputn=…)]
Specifies whether to recognize the plex command, and optionally, how to associate the AFP input tray (inputw) with the contents of the output bin. When you specify inputw, you must specify size, where size is a text string like letter, legal, a3, a4, b4, b5, ledger, or a dimension like 8.5ix11i. Dimensions can be specified as inches (i), millimeters (m), or points (p). The other three input descriptors (type, color, and weight) are optional, but when you specify them, you must separate them with a comma and no spaces.

When you do not specify inputw=size with plex, InfoPrint Manager recognizes plex mappings with no additional information for the tray contents.

Note: You can specify [ inputw=(size …)] as many times as you need to.
log_file={WorkDirectory/ps2afpd.log | PathName} DEFAULT=WorkDirectory/ps2afpd.log
Specifies the file in which the transform daemon logs errors and messages when it converts a data stream from PostScript or PDF to an AFP data stream.

Valid keyword values are:

This is the default log file, where WorkDirectory is the value of the work_directory keyword. The default work directory is /var/psf/ps2afp.
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.
mail_command={/usr/bin/mail | PathName} DEFAULT=/usr/bin/mail
Specifies the executable file that the ps2afpd command uses to send transform status notifications.

Valid keyword values are:

The AIX or Linux mail command
The full path name of a communication program

notify={root | UserID} DEFAULT=root
Identifies the user to receive notification about problems encountered during transformation of the PostScript or PDF file into an AFP data stream file. If a particular user runs most of the PostScript and PDF transform jobs, you might want to send notifications to that person using this keyword.

Valid keyword values are:

The user at the server console
An AIX or Linux user ID

ps_program={/usr/lpp/psf/bin/ps2afpi | PathName} DEFAULT=/usr/lpp/psf/bin/ps2afpi
Specifies which Postscript-or-PDF-to-AFP transform program (the PostScript interpreter) to run. Generally, you will not change this value. If you do change it, you must change the value of the ps_init_file keyword to specify an initialization file at the same level.

Valid keyword values are:

The PostScript Level 3 transform
The full path name of a PostScript interpreter file

ps_init_file={/usr/lpp/psf/ps2afp/ | PathName} DEFAULT=/usr/lpp/psf/ps2afp/
Specifies the PostScript initialization program to use with the PostScript interpreter. This file specifies the types of messages that the PostScript interpreter reports. Generally, you will not change this value. If you do change it, you must change the value of the ps_program keyword to specify a PostScript interpreter at the same level.

Valid keyword values are:

The PostScript Level 3 initialization file
The full path name of an initialization file

work_directory={/var/psf/ps2afp | PathName} DEFAULT=/var/psf/ps2afp
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 ps2afpd can use the work_directory at a time. It cannot be shared.

Values are:

The default work directory
A directory path

ps_font_map_files={/usr/lpp/psf/ps// | PathName} DEFAULT=/usr/lpp/psf/ps/
Specifies the path and file name ps2afp uses for the font mapping file. This file correlates font names with their file locations.

Valid keyword values are:

The default font mapping file
The full path name to the font mapping file


  • To restart the ps2afpd daemon with the default configuration file, enter:
    ps2afpd -C /usr/lpp/psf/ps2afp/ps2afpd.cfg