NAME
pdgwcfg.conf — HPDPS gateway printer configuration file
DESCRIPTION
When invoked, the
pdgwcfg
utility
(see
pdgwcfg(1M))
reads the configuration information from the
/etc/pdgwcfg.conf
configuration file. It is used to assist in administering
the creation and/or deletion of gateway printers in an HPDPS Basic
(non-DCE) environment.
/etc/pdgwcfg.conf
contains the following configurable values:
GatewayPrinter:[LocalHostField],LocalSpooler,RemoteHost,RemoteLogicalPrinter[,'Attributes']
- GatewayPrinter
The name of the gateway printer. Should be a contiguous string of
characters with no metacharacters. Can be the same name as the
RemoteLogicalPrinter
for naming consistency across the enterprise.
- LocalHostField
An optional field to specify on which hosts this gateway printer
should exist. It has the format:
LocalHost1|LocalHost2|...
or
-LocalHost1|-LocalHost2|...
If the field is empty, it is assumed this entry
applies to all hosts. One can explicitly define the applicable hosts by
separating the hosts with the '|' character. One can also explicitly
define an exclude list by prepending the hostname with a '-' character.
- LocalSpooler
The name of the spooler in the local environment to which
this gateway printer is to be added. The spooler must be operational
at the time the gateway printer is created.
- RemoteHost
Foreign host where the foreign logical printer exists. If the local
host on which this file is being processed matches the
RemoteHost
value, the entry is ignored (the logical printer already exists
on this local host).
- RemoteLogicalPrinter
Name of the existing foreign logical printer. It must have already
been created and be accessible at the time the gateway printer is created.
- 'Attributes'
An optional field to allow specification of attributes for the
gateway printer. The entire list of attributes should be enclosed
by one set of either '' or "" characters. It is taken as an
entire string for input into the
pdcreate(1)
command following the -x option.
Do not separate the fields by whitespace. A
#
character in the
first column indicates a comment line and will be ignored. Any
line with only whitespace will be ignored. A continuation
character
\
can be used for entries that extend to the next line.
EXAMPLES
Each line in the following example
/etc/pdgwcfg.conf
file is preceded by a comment (beginning with
#)
that explains the entry. Please note that this is
an example. Taken as a whole, it is not intended to
represent a configuration that you should use. Its
sole purpose is to show the flexibility of the
configuration file.
# /etc/pdgwcfg.conf
# HPDPS Gateway Configuration File used by pdgwcfg(1M)
# Gateway printers named 'mopier' in spoolers 'local_spl'
# will only be created on 'host8' and 'host9'.
# The logical printer 'joesmopier' is located on 'host3'.
# Note: the gateway printer can have a different name than
# the local printer.
mopier:host8|host9,local_spl,host3,joesmopier
# Gateway printers named 'hplaser' in spoolers 'dps_common_spl'
# will be created on all systems to which this file is propagated
# (since no local hosts are explicitly called out after the colon)
# except 'host2' (since that is where the printer exists).
# The logical printer is 'hplaser' located on 'host2'.
# Note: all systems have a DPS spooler named dps_common_spl running
# Note: the gateway printer can have the same name as the local
# printer for naming consistency across the enterprise.
hplaser:,dps_common_spl,host2,hplaser
# Gateway printers named 'hpdeskjet' in spoolers 'dps_common_spl'
# will be created on all systems to which this file is propagated
# except on host1, host2, and host7 (and host4 since that is
# where the printer exists).
# The logical printer is 'hpdeskjet' located on 'host4'.
# Note: all systems have a DPS spooler named dps_common_spl running
hpdeskjet:-host1|-host2|-host7,dps_common_spl,host4,hpdeskjet
# Gateway printers named 'hpcolorlaser' in spoolers 'dps_common_spl'
# will be created on all systems to which this file is propagated
# except on host5 (and host4 since that is where the printer exists).
# The logical printer is 'hpcolorlaser' located on 'host4'.
# A message attribute is provided for this gateway printer
# Note: all systems have a DPS spooler named dps_common_spl running
hpcolorlaser:\
-host5,dps_common_spl,host4,hpcolorlaser,\
"message='For Marketing Dept. use only'"
WARNINGS
Once a gateway printer is created, any subsequent modifications to
the gateway printer entry in
pdgwcfg.conf
are ignored. If gateway printer attributes
must be modified, then use
pdset
(see
pdset(1)).
If this is impractical and the gateway printer can be
deleted and recreated without impact, one could temporarily
comment out the entry and invoke
pdgwcfg
(causing the gateway printer to be deleted), then
uncomment and modify the entry in
pdgwcfg.conf
and invoke
pdgwcfg
(causing the gateway printer to be recreated).
Both the local HPDPS environment and all applicable foreign
HPDPS environments must be operating at the time the
pdgwcfg
utility is invoked.
AUTHOR
pdgwcfg.conf
was developed by HP.
