The Inbound Gateway client daemon allows users to submit print requests
using
lp
and
lpr
commands to print system
printers.
In addition, the LPD Inbound Gateway client daemon also allows applications
and PC integration software access to Advanced Printing Software even if they
are only capable of printing to the LPD based printing system.
10.1 Configuring an LPD Inbound Gateway Client Daemon
The Advanced Printing Software LPD Inbound Gateway client daemon can
either replace or coexist with the line printer daemon (lpd) of the LPD print
system.
Replacing the
lpd
daemon means that all printing
is done through the Advanced Printing Software.
When you configure the system
so that the Inbound Gateway and lpd are both present, you can use
lpr
commands to print to local remote printers.
To configure the Inbound Gateway, perform the following steps:
Ensure that the subset Advanced Printing Software lpr/lpd Gateway is installed on the spooler host or cluster.
Run the script that configures the LPD Inbound Gateway to
run with or without the
lpd
software.
This script is located
in
/usr/pd/scripts/inbound_gw_config.sh
.
When you run
the script, you will need to answer questions about the configuration you
want.
The script edits the
rc.config
file, so that each
time your system restarts or the print system restarts, your Inbound Gateway
configuration is preserved.
You can start the Inbound Gateway daemon with the following command:
# /sbin/init.d/apx start
The LPD Inbound Gateway is started automatically when the system boots.
10.1.1 Changes to the printcap File
When you configure the Inbound Gateway, you can choose to run both the Line Printer Daemon (lpd) and the Advanced Printing Inbound gateway simultaneously on a print server host. This is the most flexible setting; it allows users to submit print jobs using either the lpr or lpd client or Advanced Printing CLI and GUI clients.
To direct incoming
lpd
print jobs to Advanced Printing
printers, you must create
printcap
entries on the print
server host that associate LPD printers (specified with the
lpr
requests) with Advanced Printing logical printers.
Such
printcap
entries declare the printer as a gateway printer.
All jobs
submitted to a gateway printer are converted to Advanced Printing jobs and
are directed to the associated logical printer in an Advanced Printing spooler.
You identify an LPD printer as a gateway printer by including the expressions
rm=@dp
and
rp=<logical printer>
in the print
server host's
printcap
entry.
You should also include
the
lp
,
sd
, and
mx
options to specify (1) the printer is not on a local port, (2) the spool directory,
and (3) the maximum job size, respectively.
All other
printcap
flags in such an entry are ignored.
The following example shows an
/etc/printcap
entry
that specifies the LPD printer
bunker
as a gateway printer
associated with the Advanced Printing logical printer named
archie
:
lp1|bunker|archie|Digital LN17ps:\ :lp=:\ :rm=@dpa:\ :rp=archie:\ :sd=/var/spool/printer/archie:\ :mx#0:
When an
lpr
client or a line printer daemon on another
host passes a print job to printer
bunker
,
lpd
passes the job through the Inbound Gateway to the Advanced Printing
logical printer
archie
.
The following example shows the corresponding
printcap
entry for the client host:
lp1|bunker|Digital LN17ps:\ :lp=:\ :rm=<spooler hostname>:\ :rp=bunker:\ :mx#0:
You do not have to install Advanced Printing Software subsets on the client hosts.
The Inbound Gateway daemon shares spool directories with the Advanced
Printing spooler or spoolers.
When a job arrives at the Inbound Gateway, and
the gateway can directly access the spooler's spool directory, the gateway
stores the document files in that directory for the spooler to access.
10.2 Cancelling Advanced Printing Jobs
When you use the
lpq
command to view jobs on a gateway
printer, the output shows you all jobs queued to the printer, regardless of
whether they were submitted through the gateway.
In the output from the
lpq
command, a job entry number of 000 indicates that the job is
a native Advanced Printing job, one that was submitted using the
pdpr
command or the
pdprint
GUI, not an LPD job.
You cannot cancel native Advanced Printing jobs with the
lprm
command.
You must use the
pdrm
command to remove native
Advanced Printing jobs .
The following example shows the job cancellation message that is returned
by the
lpd
Inbound Gateway by way of an
lprm
command:
# lprm -P gwp 73 fafner_spl:1652 (73) cancelled
This
message states that LPD job 73, which had the Advanced Printing Software job
ID, fafner_spl:1652, was removed.
10.3 Mapping LPD Print Jobs to Advanced Printing Software
When an LPD print job arrives at the LPD Inbound Gateway, the job options, specified by control file keys and values, are converted to equivalent print system job and document attributes. The following tables describe the mappings between the LPD commands and their corresponding Advanced Printing attributes.
For some Xerox protocol extension options, the Advanced Printing Software
does not supply an equivalent attribute.
These extensions are indicated by
the column entry, None in the Print System Attribute column.
If a job is submitted
specifying one of these unsupported attributes, the job will fail to print
and the user will receive an e-mail message stating that the selected option
is not supported by Advanced Printing Software.
Table 10-1: LPD to Advanced Printing Software Job Mapping
Usage | Description | lpr Option | lp Options | Print System Attribute |
C(ClassName) | Class name: (banner) (job) | -C | None | job-comment |
H(Hostname) | Host submitting job: 1(job) | None | None | job-originating-host |
J(Jobname) | Name of job: (banner) (job) | -J | -t | job-name |
M(user) | User to mail when done: (job) | -m | -m | notification-profile |
N(name) | source of data file: (file) | None | None | document-name |
P(name) | requesting user: (job) | None | None | job-originator, job-owner |
S(dev) (inode) | file info: (file) | -s | Default | None |
U(file) | unlink file: (file) | -r None | None | None |
1(file) | Times Roman font file: (roff)(job) | -1 | None | None |
2(file) | Times Italic font file: (roff)(job) | -2 | None | None |
3(file) | Times Bold font file: (roff)(job) | -3 | None | None |
4(file) | Times Special font file: (roff)(job) | -4 | None | None |
Table 10-2: LPD to Advanced Printing Software Print Message Mapping
Usage | Description | lpr Option | lp Option | Print System Attribute |
c(file) | Print/plot as CIF data | -c | -T cif | document-format |
d(file) | Print as DVI data | -d | -T dvi | document-format |
f(file) | Print as ASCII | (none) | -T ascii | document-format |
g(file) | Print as plot data | -g | -T plot | document-format |
l(file) | Print converting non-printables | -l | -y catv_filter -o nofilebreak | document-format |
n(file) | Print as ditroff output | -n | -T ditroff | document-format |
o(file) | Print as PostScript | -o | -T ps -T PostScript | document-format |
p(file) | Print through pr | -p | -T pr | document-format |
r(file) | Print as fortran | -f | -T fortran | document-format |
t(file) | Print as troff output | -t | -T troff | document-format |
v(file) | Print as raster image | -v | -T raster | document-format |
Table 10-3: Sun Protocol Extensions to Advanced Printing Software
CF Key | Description | lpr Option | lp Options | Print System Attribute |
O(option_list) | For SVR4 LP -o option | None | -o option_list | Ignored |
5(opt)(value) | For SVR4 LP features | None | Not an option | |
5f(form) | For SVR4 Forms | None | -f form_name | Ignored |
5H(handling) | For SVR4 Handling | None | -H -f form_name | Ignored |
5p(method:end) | For SVR4 Notification | None | -p | Ignored |
5P(pagelist) | For SVR4 Pages | None | -P page_list | page-select |
5q(priority) | For SVR4 Priority | None | -q priority | job-priority |
5S(char_set) | For SVR4 Charset | None | -S char_set | Ignored |
5T(type) | For SVR4 Type | None | -T input_type | Document-format |
5y(mode) | For SVR4 Mode | None | -y filter_mode | Ignored |
Table 10-4: DIGITAL Protocol Extensions
CF Key | Description | lpr Option | lp Options | Print System Attribute |
<(tray) | Input tray selection | -I (upper|lower|manual|...) | None | default-input-tray |
>(bin) | Output bin selection | -o (bin) | None | output-bin |
G(nup) | Number up | -N(nup) | None | number-up |
K(sides/plex) | Sides | -K (sides/plex) | None | sides, plex |
O(options) | Page orientation | -O (options) | None | filter options |
6L(length | Page length | -Z (length) | None | length |
NOTE
Xerox extensions that are not supported by the Advanced Printing Software are listed as (no mapping) in the Print System Attribute column of the following table. Any jobs that are submitted specifying these unsupported extensions will not print. The user that submits a job using an unsupported extension receives a mail message stating that the option selected is not supported and therefore the job did not print.
Table 10-5: Xerox Protocol Extensions - DocuSP and DocuPrint to Advanced Printing Software
CF Key | Description | lpr Option | lp Options | Print System Attribute |
C" (doc-format)" | Document format, doc-format= ps postscriptascii tiff pcl interpress ip lcds (not supported) |
-C | -o | document-format= PostScript PostScript simple-text TIFF PCL Interpress Interpress LCDS |
C" (orientation) " | Document orientation, orientation= portrait inverseportrait iportrait landscape inverselandscape ilandscape | -C | -o | content-orientation= portrait reverse-portrait landscape reverse-landscape |
C" (staple) " | Document stapling, staple= staple nostaple | -C | -o | finishing= staple-top-left |
C" (order)" | Page order, order= 1ton nto1 | -C | -o | page-order-received= first-to-last last-to-first |
C" (simplex)" | One-sided printing | -C | -o | sides=1 |
C" (duplex)" | Two-sided printing | -C | -o | sides=2 |
C" (tumble)" | Head-to-toe printing | -C | -o | sides=2, plex=tumble |
C" (mediumsize)" | Medium size, mediumsize= usletter uslegal a4 USLetter USLegal usledger a0 a1 a2 a3 a4 a5 a6 a7 a8 a9 a10 isob0 isob1 isob2 isob3 isob4 isob5 isob6 isob7 isob8 isob9 isob10 jisb0 jisb1 jisb2 jisb3 jisb4 jisb5 jisb6 | -C | -o | default-medium= na-letter-white na-legal-white iso-a4-white na-letter-white na-legal-white ledger-white iso-a0-white iso-a1-white iso-a2-white iso-a3-white iso-a4-white iso-a5-white iso-a6-white iso-a7-white iso-a8-white iso-a9-white iso-a10-white iso-b0-white iso-b1-white iso-b2-white iso-b3-white iso-b4-white iso-b5-white iso-b6-white iso-b7-white iso-b8-white iso-b9-white iso-b10-white jis-b0-white jis-b1-white jis-b2-white jis-b3-white jis-b4-white jis-b5-white jis-b6-white |
C" (xshift=x)" | Shift the page in the x direction | -C | -o | x-image-shift=x |
C" (yshift=x)" | Shift the page in the y direction | -C | -o | y-image-shift=y |
C" (font)" | Font name | -C | -o | (no mapping) |
NOTE
Xerox extensions that are not supported by the Advanced Printing Software are listed as (no mapping) in the Print System Attribute column of the following table. Any jobs that are submitted specifying these unsupported extensions will not print. The user that submits a job using an unsupported extension receives a mail message stating that the option selected is not supported and therefore the job did not print.
Table 10-6: Xerox Protocol Extensions to Advanced Printing Software- DocuSP Only
CF Key | Description | lp Option | lpr Options | Print System Attribute |
C" (bind=edge) " | Binding edge, edge= top bottom left right | -C | -o | Binding edge, edge= top bottom left right |
C" (stitch=how)" | -C | -o | finishing= staple-top-left staple-bottom-left edge-stitch | |
C" (uncollate) " | Collation | -C | output=no-page-collate | |
C" (booklet) " | Finishing | -C | finishing=saddle-stitch | |
C" (signature)" | Signature option | -C | -o | number-up=simple-2-up |
C" (slipsheet)" | Slipsheet option | -C | -o | job-sheets=job-copy-wrap |
C" (prefinish= <option>) " | Media prefinish option | -C | -o | None |
C" (pagestoprint =<CARDINAL> <CARDINAL>)" | Pages option | -C | -o | None |
C" (media=<size>: <type>: < color>: <weight>)" | Media custom option | -C | -o | None |
C" (mediaType= <type>) " | Media custom option | -C | -o | None |
C" (mediatSize= <size>) " | Media custom option | -C | -o | None |
C" (mediaColor= <color>) " | Media custom option | -C | -o | None |
C" (mediaWeight =<weight>) " | Media custom option | -C | -o | None |
C" (opacity= transparency| opaque)" | Miscellaneous option | -C | -o | None |
C" (xshift2=x)" | Shifts the back side of the page in the x direction | -C | -o | None |
C" (yshift2=x)" | Shift the back side of the page in the y direction | -C | -o | None |
C" (account= <text>)" | Account option | -C | -o | None |
C" (hipentry= <CARDINAL>)" | LCDS index option | -C | -o | None |
C" (recipient= <name>)" | Recipient option | -C | -o | None |
C" (res= <CARDINAL>)" | Resolution option | -C | -o | None |
C" (outputbin)" | Miscellaneous option | -C | -o | None |
C" (inputbin)" | Miscellaneous option | -C | -o | None |
C" (thicken)" | Miscellaneous option | -C | -o | None |
C" (offenhance)" | Miscellaneous option | -C | -o | None |
C" (onenhance)" | Miscellaneous option | -C | -o | None |
C" (bp)" | Miscellaneous option | -C | -o | None |
C" (ep)" | Miscellaneous option | -C | -o | None |
C" (diagnostic)" | Miscellaneous option | -C | -o | None |
NOTE
Xerox extensions that are not supported by the Advanced Printing Software are listed as (no mapping) in the Print System Attribute column of the following table. Any jobs that are submitted specifying these unsupported extensions will not print. The user that submits a job using an unsupported extension receives a mail message stating that the option selected is not supported and therefore the job did not print.
Table 10-7: Xerox Protocol Extensions to Advanced Printing Software - DocuPrint Only
CD Key | Description | lpr Option | lp Options | Print System Attribute |
C" (hc=color) " | Highlight colour, color= red blue green cyan magenta yellow cardinal royalblue ruby violet customName customName | -C | --- | Highlight colour, color= red blue green cyan magenta yellow cardinal royalblue ruby violet customName customName |
C" (mc=color)" | Highlight mapping color, color values are same as for highlight colour, color | -C | --- | Highlight-mapping-colour, values same as for highlight-colour |
C" (hcr=rendering)" | Highlight color rendering algorithm, rendering= automatic colortohighlight colortables presentation pictorial | -C | --- | Highlight color rendering algorithm, rendering= automatic colortohighlight colortables presentation pictorial |
C" (hcm=action)" | Highlight color mismatch action, action= abort ignore operator | -C | --- | Highlight color mismatch action, action= abort ignore operator |
C" (stitch)" | Document stapling, stitch= stitch nostitch | -C | --- | finishing= staple-top-left --- |
C" (thick=x))" | thickening, x= 01 10 | -C | -o | thickening-specification= thickening-entire-documents thickening-bit-map-images |
C" (drilled) " | Media prefinish option | -C | --- | None |
C" (media=<size>: <type>: <paper color>: <weight>)" | Media custom option | -C | -o | None |
C" (<n>x<m>) " | Media custom option | -C | --- | None |
C" (size)" | Font size | -C | --- | None |
C" (fontsize)" | Font size | -C | --- | None |
C" (disposition=<>)" | Decomp service option | -C | --- | None |
C" (background=<>)" | Decomp service option | -C | --- | None |
C" (bf=<>)" | Decomp service option | -C | --- | None |