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 agspdld, 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}

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

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}

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}

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}

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}

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}

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

ps_font_map_files={/usr/lpp/psf/ps//psfonts.map | PathName}

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:

/usr/lpp/psf/ps/psfonts.map: The default font mapping file
PathName: The full path name to the font mapping file

Examples

To restart the ps2afpd daemon with the default configuration file, enter:
```
ps2afpd -C /usr/lpp/psf/ps2afp/ps2afpd.cfg
```
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

RICOH InfoPrint Manager™ for Linux

ps2afpd utility: starts the ps2afpd daemon

Syntax

Description

Flag

Configuration file keywords and values

Examples

Files