10    LPD Inbound Gateway Client Daemon

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:

  1. Ensure that the subset Advanced Printing Software lpr/lpd Gateway is installed on the spooler host or cluster.

  2. 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.

  3. 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