Technical data

job-state-message attribute, and through an error page that is printed
on the target physical printer. When an error occurs, the job is put into the
retained state on the spooler.
8.1.5 Creating a Filter Program
Filter programs must adhere to the following rules:
• The program must read from stdin.
• The program msut write only document data to stdout. No error
messages or other messages are allowed.
• The program must not emit printer control strings.
• The command executable cannot be replaced by a non-privileged user.
8.2 Using the Text-to-PostScript Translation Filter
Advanced Printing Software includes one translation filter. This program
translates simple text documents to PostScript and, optionally, performs
number-up processing. This filter is stored during the installation procedure
as /usr/pd/bin/trn_textps.
Simple text format documents sent to printers that handle only the PostScript
language need to be translated to PostScript. This translation occurs when
the document’s document-format attribute value is simple-text and
the physical printer, native-document-formats-ready attribute value
is PostScript. If other formats, in particular PCL, are specified by the
native-document-formats-ready attribute, the supervisor sends the
data directly to the printer.
The print system software includes a command script,
/usr/pd/scripts/pd_get_started, that automatically config-
ures the text-to-PostScript translation filter when you create a supervisor.
Table 8–2 lists all the command options supported by the text-to-PostScript
translator program. Administrators can set up the filter-definition
attribute with command option substitutions that relate print system
attributes to translation options.
The following example shows how the command options are used.
# pdset -c server \
-x filter-definition=\
’{name=text-to-ps \
type=translation \
input-format=simple-text \
output-format=PostScript \
command="/usr/pd/bin/trn_textps -N${number-up,0} \
${content-orientation,,-O${content-orientation}} \
8–8 Document Data Filtering