ps2afpd utility: starts the ps2afpd daemon

Syntax

ps2afpd [-C ConfigurationFile]

Description

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.

Flag

The ps2afpd daemon utility uses the following flag:

-C ConfigurationFile
Specifies the configuration file InfoPrint uses with the transform. The value is:
ConfigurationFile
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:

WorkDirectory/ps2afpd.log
This is the default log file, where WorkDirectory is the value of the work_directory keyword. The default work directory is /var/psf/ps2afp.
PathName
The full path name of a log file

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:

/usr/bin/mail
The AIX or Linux mail command
PathName
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:

root
The user at the server console
UserID
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:

/usr/lpp/psf/bin/ps2afpi
The PostScript Level 3 transform
PathName
The full path name of a PostScript interpreter file

ps_init_file={/usr/lpp/psf/ps2afp/ps2afp.ps | PathName} DEFAULT=/usr/lpp/psf/ps2afp/ps2afp.ps |
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:

/usr/lpp/psf/ps2afp/ps2afp.ps
The PostScript Level 3 initialization file
PathName
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:

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

Examples

  • To restart the ps2afpd daemon with the default configuration file, enter:
    ps2afpd -C /usr/lpp/psf/ps2afp/ps2afpd.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 ps2afpd daemon.
    2. Anyone can start the ps2afpd daemon, but only a person with root user authority can stop it.
  • To restart the ps2afpd daemon with the configuration file myfile.cfg, which resides in the directory /usr/lpp/psf/ps2afp, enter:
    ps2afpd -C /usr/lpp/psf/ps2afp/myfile.cfg

Files

/usr/lpp/psf/bin/ps2afpd
PostScript 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/ps2afpd.cfg
ps2afpd daemon configuration file
/usr/lpp/psf/ps2afp/ps2afp.cfg
ps2afp command configuration file
/usr/lpp/psf/bin/ps2afpi
PostScript level 3 interpreter program
/usr/lpp/psf/bin/ps2afpi.vm
PostScript interpreter program initial virtual memory
/usr/lpp/psf/ps2afp/ps2afp.ps
PostScript initialization file
/usr/lpp/psf/ps2afp/ps2afpe.ps
PostScript initialization file for extended error reporting
/usr/lpp/psf/ps2afp/psfonts.map
Default PostScript font mapping file
/var/psf/psfonts
User-defined PostScript fonts file