HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

p
pdgwcfg(1M) pdgwcfg(1M)
(TO BE OBSOLETED)
NAME
pdgwcfg - configures HPDPS gateway printers in a Basic environment
SYNOPSIS
pdgwcfg [-a|-m] [-h] [-p] [-v]
DESCRIPTION
The pdgwcfg utility simplifies the configuration of HPDPS gateway printers in a Basic (non-DCE
Extended) environment by reading an administrator-supplied configuration file
/etc/pdgwcfg.conf
(see pdgwcfg.conf(4)). It creates-enables and/or deletes gateway printers as appropriate. Gateway printers
are similar to "remote printers" provided by the LP spooler, allowing access to a printer in a foreign (DCE
Extended or Basic) environment.
You must have super-user privileges to invoke the utility. The default behavior of the utility will not
modify any previously-created gateway printers listed in
/etc/pdgwcfg.conf
. Any new entries will be
created and any gateway printers not listed will be deleted.
All output is sent to
$PDBASE/pdgwcfg/error.log
(or /var/opt/pd/pdgwcfg/error.log
by
default). Previous error logs are retained in separate files in this directory for reference and, if used exten-
sively, the directory may need to be cleaned-up periodically. If a severe error is encountered that causes a
premature abort, an error message is also sent to stderr.
Options
pdgwcfg uses the following options:
-a Retain all previously-created gateway printers, even if they are no longer listed in
/etc/pdgwcfg.conf
. No gateway printers will be deleted. The administrator must manually
remove any unwanted gateway printers.
-m Retain any manually-created gateway printers. These would not contain the text
PDGWCFG-
MARKER
in the descriptor attribute which is placed there by the pdgwcfg utility when it creates a
gateway printer. This option is intended for scenarios where /etc/pdgwcfg.conf
is not used
exclusively for gateway printer configuration (e.g. a local sysadmin also creates gateway printers
without the utility).
-h Provides invocation syntax help.
-p Preview mode. No changes to the gateway configuration will actually be made. For best results, the
local HPDPS system should be running so that the utility can query the system to determine which
gateway printers, if any, would be created/deleted.
-v Verbose mode. Provides more extensive output in the
error.log.
RETURN VALUE
pdgwcfg exits with one of the following values:
0 Successful completion.
1 Failure.
EXTERNAL INFLUENCES
Environment Variables
PATH needs to include at a minimum /usr/bin:/opt/pd/bin.
PDBASE affects the location of the error.log
EXAMPLES
If it is desirable to have a single configuration file distributed across multiple systems, there are various
ways to distribute the configuration file and have the utility invoked to configure a system (e.g.
swinstall(1M), rdist(1), etc.). Each method should be weighed against the administration and security con-
cerns of your particular environment.
The below is just an example using rdist(1) and is not intended to be a recommendation.
# sample distfile for use with rdist
# copies /etc/pdgwcfg.conf and invokes the pdgwcfg utility
# invoke as ’rdist -b -h -f distfile’
HOSTS = ( host7 host8 )
Section 1M−−668 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005